# Macy's Scraper (`autofacts/macy-s-scraper`) Actor Scrape Macy's product catalog and Macy's Inc. news in one actor. Extract prices, variants, SKUs/UPCs, color & size options, images, ratings and reviews from search, category, trending, and product URLs. Powered by Macy's APIs no browser, Akamai-proof, fast, clean normalized JSON. - **URL**: https://apify.com/autofacts/macy-s-scraper.md - **Developed by:** [Richard Feng](https://apify.com/autofacts) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.50 / 1,000 product scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Macy's Product & News Scraper Extract **full Macy's catalog data** โ€” products, prices, variants, SKUs/UPCs, images, ratings, and reviews โ€” plus **Macy's Inc. newsroom articles**, all as clean, normalized JSON. Search by keyword, scrape a category, pull trending products, or paste any `macys.com` product URL. No browser, no HTML parsing, no bot-challenge headaches. ### What does Macy's Scraper do? **Macy's Scraper** pulls structured product and editorial data straight from Macy's own backend APIs and returns it in a single, consistent schema: - ๐Ÿ”Ž **Product search** โ€” any keyword (`"dresses"`, `"nike men shoes"`, `"kitchen"`) โ†’ paginated product results. - ๐Ÿ—‚๏ธ **Category / listing pages** โ€” paste a `macys.com/shop/...` category URL or supply a category ID. - ๐Ÿ”ฅ **Trending & featured** โ€” bestseller / trending / curated landing pages. - ๐Ÿงพ **Product detail** โ€” full descriptions, every color & size, per-SKU UPC barcodes, pricing tiers, image galleries, star ratings & review counts. - ๐Ÿ“ฐ **Macy's Inc. news** โ€” press releases and newsroom articles from `macysinc.com` (title, author, date, body, images). Every record is normalized to the same top-level shape (`source / title / brand / price / options / variants / medias / stats`), so downstream code doesn't care whether an item came from search, a category, or a product page. ### Why use Macy's Scraper? - **Beats Akamai without a browser.** `www.macys.com` sits behind Akamai Bot Manager โ€” plain HTTP clients are blocked outright and even fingerprinted headless browsers stall at the JS challenge. This actor talks to Macy's **mobile app API** and **website JSON API** instead, which run on separate infrastructure and answer anonymous read requests. Result: **seconds per page, not minutes**, and no browser farm to babysit. - **Real SKUs, not guesses.** Each purchasable variant carries its own **UPC barcode**, color, size, availability, and price โ€” recovered from Macy's `upcs` relationship data, not scraped off a swatch widget. - **Prices as integer cents.** Sale, list, and previous prices are returned as integers (`5999` = `$59.99`) so you never fight floating-point rounding โ€” with the localized formatted strings alongside (`"$59.99"`). - **One SKU per product.** All shades/sizes are grouped under a single dataset item with a `variants[]` array โ€” not one row per variant. - **Clean, public URLs only.** Output `canonicalUrl` is always the real shopper-facing product page. Internal API endpoints, client keys, and query params never leak into your dataset. - **Four surfaces, one actor.** Search, category, trending, and news in a single run via the `all` mode. - **Export anywhere.** Download as JSON, CSV, Excel, or HTML, or pull straight from the dataset API. ### How to use Macy's Scraper 1. Open the **Input** tab. 2. Pick a **Scrape type** (`search`, `category`, `trending`, `news`, or `all`). 3. Fill the matching field: - **Search products** โ†’ set **Search query** (e.g. `dresses`). - **Category products** โ†’ paste category URLs into **Start URLs**, or add **Category IDs**. - **Trending products** โ†’ add **Trending URLs**. - **News articles** โ†’ add **News URLs** (defaults to the Macy's Inc. press-release feed). 4. (Optional) Toggle **Fetch product details** off for faster, listing-level records. 5. Choose a **Proxy** โ€” Apify **Residential, country US** is recommended. 6. Click **Start**, then download from the **Dataset** tab. > **Tip:** Set `maxPages: 1` and `maxResults: 10` for a quick smoke test before a full run. ### Input | Field | Type | Description | |---|---|---| | `scrapeType` | enum | `search`, `category`, `trending`, `news`, or `all` (combine every provided input). Default `search`. | | `query` | string | Keyword for product search, e.g. `women shoes`. | | `startUrls` | array | Macy's product/category URLs **or** Macy's Inc. news URLs. Augments generated inputs. | | `categoryIds` | array | Macy's category IDs (e.g. `5449`). Category URLs are preferred when known. | | `trendingUrls` | array | Trending / bestseller / curated listing URLs. | | `newsUrls` | array | Macy's Inc. news listing or article URLs. | | `includeProductDetails` | boolean | When `true` (default), each listing item is enriched with the full product-detail JSON (descriptions, variants, SKUs, galleries). Turn off for faster listing-level output. | | `maxPages` | integer | Max pagination depth per listing/news source. Default `20`. | | `maxResults` | integer | Cap on output records. `0` = no cap. | | `minResults` | integer | Fail the run if fewer records are produced (handy for live smoke tests). | | `maxRequestsPerCrawl` | integer | Hard cap on total requests. `0` = Crawlee default. | | `maxConcurrency` | integer | Concurrent requests. Default `3`. | | `proxy` | object | **Required.** Apify Proxy or custom proxy URLs. Residential / country `US` recommended. | ### Supported URL types | Type | Example | |---|---| | Product detail | `https://www.macys.com/shop/product/...?ID=12345678` | | Category / listing | `https://www.macys.com/shop/womens-clothing/womens-dresses?id=5449` | | Featured / keyword landing | `https://www.macys.com/shop/featured/dresses` | | Trending | `https://www.macys.com/shop/featured/trending-now` | | News listing (RSS) | `https://www.macysinc.com/rss/pressrelease.aspx` | | News article | `https://www.macysinc.com/newsroom/news/...` | > Category URLs are preferred over bare category IDs โ€” the URL carries the category path the API needs. Purely editorial featured pages (no product grid) may legitimately return no products. ### Output Each dataset item follows the schema in `.actor/dataset_schema.json`. Product example (abridged): ```json { "type": "product", "source": { "id": "12345678", "canonicalUrl": "https://www.macys.com/shop/product/calvin-klein-womens-sheath-dress?ID=12345678", "retailer": "macys", "language": "en-US", "currency": "USD" }, "scrapeContext": { "type": "search", "query": "dresses", "listUrl": "search:dresses" }, "title": "Women's Sleeveless Sheath Dress", "brand": "Calvin Klein", "description": "A polished sleeveless sheath in a stretch crepe...", "categories": ["Women", "Dresses", "Work Dresses"], "price": { "sale": 5999, "list": 9800, "previous": 9800, "currentFormatted": "$59.99", "listFormatted": "$98.00", "previousFormatted": "$98.00", "stockStatus": "InStock" }, "stats": { "rating": 4.6, "reviewCount": 9, "ratingRange": 5, "ratingPercentage": 92, "recommendedCount": 5, "notRecommendedCount": 1, "ratingDistribution": [ { "rating": 5, "count": 8 }, { "rating": 1, "count": 1 } ], "secondaryRatings": [ { "id": "OverallSize", "label": "Runs Small/Runs Large", "value": 4, "valueLabel": "neutral", "minLabel": "Runs Small", "maxLabel": "Runs Large", "range": 7 } ], "reviewSources": ["BV"] }, "details": { "features": ["Square neckline; Sheath silhouette", "Back zip closure", "Lined", "Imported"], "sizeAndFit": ["Approx. 25-3/4\" long", "Tailored fit through the chest, waist, and hips; sits close to the body"], "materialsAndCare": ["68% cotton, 29% polyester, 3% spandex; lining: 100% polyester", "Machine wash"], "specialSizes": ["Regular"], "bullets": ["Approx. 25-3/4\" long", "Tailored fit through the chest, waist, and hips", "68% cotton...", "Machine wash", "Imported"] }, "options": [ { "type": "Color", "values": [ { "id": "1", "name": "Black", "swatchIcon": { "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/.../swatch.jpg" } } ] }, { "type": "Size", "values": [ { "id": "10", "name": "M" }, { "id": "12", "name": "L" } ] } ], "variants": [ { "id": "987654", "sku": "192837465012", "options": ["Black", "M"], "price": { "stockStatus": "InStock" }, "extraInfo": { "upc": "192837465012" } } ], "medias": [ { "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/.../main.jpg", "index": 0 } ], "extraInfo": { "sourceType": "xapi-json", "topLevelCategory": "Women" } } ```` News example (abridged): ```json { "type": "article", "source": { "id": "macys-inc-press-2026-001", "canonicalUrl": "https://www.macysinc.com/newsroom/news/...", "retailer": "macys", "publishedUTC": 1751500800000 }, "scrapeContext": { "type": "news" }, "title": "Macy's, Inc. Reports Quarterly Results", "author": "Macy's, Inc.", "publishedAt": "2026-06-30", "summary": "...", "bodyText": "...", "images": [ { "type": "Image", "url": "https://www.macysinc.com/.../hero.jpg" } ] } ``` Download as JSON, CSV, XLSX, or HTML from the **Dataset** tab. ### Data fields | Field | Type | Notes | |---|---|---| | `type` | enum | `product` or `article`. | | `source.id` | string | Macy's product ID or article ID. | | `source.canonicalUrl` | string | Public, shopper-facing page URL. Never an internal API endpoint. | | `source.retailer` | string | Always `macys`. | | `source.currency` | string | `USD`. | | `title` | string | Product name / article headline. | | `brand` | string | Product brand. | | `description` | string | Full product description. | | `categories` | array | Taxonomy breadcrumb names. | | `price.sale` / `list` / `previous` | integer | **Integer cents** (`5999` = `$59.99`). | | `price.*Formatted` | string | Localized display strings (`"$59.99"`). | | `price.stockStatus` | enum | `InStock` / `LowInStock` / `OutOfStock` / `Unknown`. | | `stats.rating` / `reviewCount` | number | Average overall rating and total review count. | | `stats.ratingPercentage` / `recommendedCount` / `notRecommendedCount` | number | Recommend %, and recommend / not-recommend counts. | | `stats.ratingDistribution[]` | array | Star histogram: `{ rating, count }` per star value. | | `stats.secondaryRatings[]` | array | PDP slider ratings (e.g. **Length**, **Coverage**, **Overall Size**): `id`, `label`, `value`, `minLabel`/`maxLabel`, `range`. | | `details.features[]` | array | **Features / product details** bullets. | | `details.sizeAndFit[]` | array | **Size & Fit** bullets (length, fit, silhouette). | | `details.materialsAndCare[]` | array | **Materials & Care** bullets (fabric composition, wash/care). | | `details.specialSizes[]` / `details.bullets[]` | array | Size types (e.g. Regular, Petite) and the full combined bullet list. | | `options[]` | array | `Color` / `Size` option groups, each value with `id`, `name`, and (colors) a `swatchIcon`. | | `variants[]` | array | One purchasable SKU per entry: `id`, **`sku` (UPC barcode)**, `options` (color/size), per-SKU `price`, `extraInfo.upc`. | | `medias[]` | array | Product image gallery (`type`, `url`, `index`). | | `author` / `publishedAt` / `summary` / `bodyText` / `images` | โ€” | Article-only fields. | ### How it works Macy's storefront HTML (`www.macys.com/shop/...`) is guarded by Akamai Bot Manager. Rather than fight the JS challenge, this actor uses Macy's own APIs, which live on separate infrastructure: - **Listings (search / category / trending)** โ†’ the Macy's **mobile app API** (`api.macys.com/xapi/mobileapp/browse/v1/search`), authenticated with the app's embedded non-protected client key (no login). Responses are **protobuf**, decoded by a small dependency-free reader. - **Product detail** โ†’ the website **JSON API** (`www.macys.com/xapi/digital/v1/product/{id}`), which returns full descriptions, `upcs` (SKU/UPC), color/size maps, pricing tiers, and image galleries. - **News** โ†’ the Macy's Inc. newsroom (`www.macysinc.com`), which is not behind Akamai. `includeProductDetails` (default `true`) controls whether listing results are enriched with the full product JSON, or emitted as lighter listing-level records built directly from the mobile response. ### Tips & advanced options - **Use residential US proxies.** The product-detail endpoint is intermittently rate-limited; `retryOnBlocked` + Apify residential session rotation gets through cleanly. Datacenter IPs are more likely to see 403s. - **Keep concurrency modest.** `maxConcurrency` of `2โ€“3` is the sweet spot. Higher values raise rate-limit rates without improving throughput. - **Smoke test first.** Set `maxPages: 1`, `maxResults: 10`, and `minResults: 1` to confirm your input shape before a full crawl. - **Prefer category URLs over IDs.** The URL carries the category path the API expects; a bare ID may resolve to a broader or empty result set. - **Turn off `includeProductDetails`** for a fast listing-level sweep (name, brand, listing price, image, rating) when you don't need variants/descriptions. ### FAQ **Do I need a login, cookie, or API key?** No. The actor uses Macy's own anonymous, read-only app/website APIs โ€” no account, no token beyond your Apify proxy. **Are the prices in dollars or cents?** Integer **cents** (`5999` = `$59.99`) to avoid floating-point rounding. Each price also carries a localized formatted string. **Why don't I see the internal API URLs in my dataset?** By design. Output `canonicalUrl` is always the public product/article page a shopper would visit; the internal fetch endpoints, client keys, and query params stay in logs, never in output. **Some trending/featured pages return no products โ€” is that a bug?** No. Purely editorial landing pages (e.g. `trending-now`) may have no underlying product grid. Use a real category URL/ID or a search query for guaranteed product results. **Can I scrape multiple surfaces in one run?** Yes. Set `scrapeType: "all"` and provide any mix of `query`, `startUrls`, `categoryIds`, `trendingUrls`, and `newsUrls`. **Will re-running the same input re-scrape everything?** Yes. Each run starts with a fresh request queue, so hitting **Start** again re-scrapes every source. Split into batches for very large crawls. **Legality / Terms of Service.** Web scraping legality depends on jurisdiction and intended use. Review Macy's Terms of Service and consult counsel before running at scale. This actor is provided as-is for research, price monitoring, competitive analysis, and other lawful use cases, and collects only publicly available data. ### Support Questions, bugs, or feature requests (historical backfills, additional Macy's surfaces, custom fields) โ€” open an issue on the Apify listing or contact the autofacts team. # Actor input Schema ## `scrapeType` (type: `string`): Which Macy's surface to scrape. Use all to combine generated inputs and start URLs. ## `query` (type: `string`): Keyword used for Macy's product search. Example: women shoes. ## `startUrls` (type: `array`): Macy's product listing/detail URLs or Macy's Inc news URLs. These augment generated query/category/trending URLs. ## `categoryIds` (type: `array`): Optional Macy's category IDs. Category URLs are preferred when known. ## `trendingUrls` (type: `array`): Optional Macy's trending, bestseller, or curated listing URLs. ## `newsUrls` (type: `array`): Optional Macy's Inc news listing or article URLs. ## `includeProductDetails` (type: `boolean`): When enabled, listing pages enqueue each product detail page before output. ## `maxPages` (type: `integer`): Maximum pagination depth per listing/news source. Default 1 keeps the out-of-the-box run fast; raise it for deeper crawls. ## `maxResults` (type: `integer`): Maximum product/article records to push. Default 20 keeps the out-of-the-box run quick (within Apify's automated test budget); set 0 for no cap. ## `minResults` (type: `integer`): Fail the run when fewer records are produced. Useful for live smoke tests. ## `maxRequestsPerCrawl` (type: `integer`): Maximum crawler requests. Default 20 bounds the quick default run within Apify's automated test budget; raise for larger crawls, or 0 for the Crawlee default. ## `maxConcurrency` (type: `integer`): Actor max concurrency. ## `debugSaveHtml` (type: `boolean`): For development only. Saves fetched HTML/XML responses to the default key-value store. ## `proxy` (type: `object`): Required. Every request is routed through Apify Proxy or explicit proxy URLs. Local dev may load APIFY\_PROXY\_PASSWORD from ../proxy.txt. ## Actor input object example ```json { "scrapeType": "search", "query": "dresses", "startUrls": [ { "url": "https://www.macys.com/shop/featured/dresses" }, { "url": "https://www.macysinc.com/newsroom/news/default.aspx" } ], "trendingUrls": [ { "url": "https://www.macys.com/shop/featured/trending-now" } ], "newsUrls": [ { "url": "https://www.macysinc.com/rss/pressrelease.aspx" } ], "includeProductDetails": true, "maxPages": 1, "maxResults": 20, "minResults": 0, "maxRequestsPerCrawl": 20, "maxConcurrency": 3, "debugSaveHtml": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `products` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "dresses", "startUrls": [ { "url": "https://www.macys.com/shop/featured/dresses" }, { "url": "https://www.macysinc.com/newsroom/news/default.aspx" } ], "trendingUrls": [ { "url": "https://www.macys.com/shop/featured/trending-now" } ], "newsUrls": [ { "url": "https://www.macysinc.com/rss/pressrelease.aspx" } ], "maxConcurrency": 3, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("autofacts/macy-s-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "dresses", "startUrls": [ { "url": "https://www.macys.com/shop/featured/dresses" }, { "url": "https://www.macysinc.com/newsroom/news/default.aspx" }, ], "trendingUrls": [{ "url": "https://www.macys.com/shop/featured/trending-now" }], "newsUrls": [{ "url": "https://www.macysinc.com/rss/pressrelease.aspx" }], "maxConcurrency": 3, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("autofacts/macy-s-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "dresses", "startUrls": [ { "url": "https://www.macys.com/shop/featured/dresses" }, { "url": "https://www.macysinc.com/newsroom/news/default.aspx" } ], "trendingUrls": [ { "url": "https://www.macys.com/shop/featured/trending-now" } ], "newsUrls": [ { "url": "https://www.macysinc.com/rss/pressrelease.aspx" } ], "maxConcurrency": 3, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call autofacts/macy-s-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=autofacts/macy-s-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Macy's Scraper", "description": "Scrape Macy's product catalog and Macy's Inc. news in one actor. Extract prices, variants, SKUs/UPCs, color & size options, images, ratings and reviews from search, category, trending, and product URLs. Powered by Macy's APIs no browser, Akamai-proof, fast, clean normalized JSON.", "version": "0.0", "x-build-id": "EsgyNKFkhnTXqExhR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/autofacts~macy-s-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-autofacts-macy-s-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/autofacts~macy-s-scraper/runs": { "post": { "operationId": "runs-sync-autofacts-macy-s-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/autofacts~macy-s-scraper/run-sync": { "post": { "operationId": "run-sync-autofacts-macy-s-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "scrapeType": { "title": "Scrape type", "enum": [ "search", "category", "trending", "news", "all" ], "type": "string", "description": "Which Macy's surface to scrape. Use all to combine generated inputs and start URLs.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Keyword used for Macy's product search. Example: women shoes." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Macy's product listing/detail URLs or Macy's Inc news URLs. These augment generated query/category/trending URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categoryIds": { "title": "Macy's category IDs", "type": "array", "description": "Optional Macy's category IDs. Category URLs are preferred when known.", "items": { "type": "string" } }, "trendingUrls": { "title": "Trending URLs", "type": "array", "description": "Optional Macy's trending, bestseller, or curated listing URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "newsUrls": { "title": "News URLs", "type": "array", "description": "Optional Macy's Inc news listing or article URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeProductDetails": { "title": "Fetch product details", "type": "boolean", "description": "When enabled, listing pages enqueue each product detail page before output.", "default": true }, "maxPages": { "title": "Max listing pages per source", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum pagination depth per listing/news source. Default 1 keeps the out-of-the-box run fast; raise it for deeper crawls.", "default": 1 }, "maxResults": { "title": "Max output records", "minimum": 0, "type": "integer", "description": "Maximum product/article records to push. Default 20 keeps the out-of-the-box run quick (within Apify's automated test budget); set 0 for no cap.", "default": 20 }, "minResults": { "title": "Minimum output records", "minimum": 0, "type": "integer", "description": "Fail the run when fewer records are produced. Useful for live smoke tests.", "default": 0 }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 0, "type": "integer", "description": "Maximum crawler requests. Default 20 bounds the quick default run within Apify's automated test budget; raise for larger crawls, or 0 for the Crawlee default.", "default": 20 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Actor max concurrency.", "default": 3 }, "debugSaveHtml": { "title": "Save debug HTML snapshots", "type": "boolean", "description": "For development only. Saves fetched HTML/XML responses to the default key-value store.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Required. Every request is routed through Apify Proxy or explicit proxy URLs. Local dev may load APIFY_PROXY_PASSWORD from ../proxy.txt." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```