Macy's Scraper

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 from Macy's 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.
• 🔥 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?

• Fast, no browser. 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, with no tracking or query params.
• Four surfaces, one actor. Search, category, trending, and news in a single run — paste URLs of each kind side by side.
• 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. Under What to scrape, paste Macy's links into Start URLs — any mix of product, category, featured, and trending pages, plus Macy's Inc. news articles, the newsroom page, or the press-release feed — and/or type a Search query (e.g. dresses). Each link's type is recognized automatically.
3. Under How much to collect, set Max result records — each record is one billed result.
4. (Optional) Turn Full product details off for faster, listing-level records.
5. Keep the default Proxy — Apify Residential, country US.
6. Click Start, then download from the Dataset tab.

Tip: Set Max result records to 10 for a quick smoke test before a full run.

📋 Input

Field	Type	Description
startUrls	array	Any mix of Macy's product, category, featured, or trending URLs and Macy's Inc. news URLs (an article, the newsroom page, or the press-release feed). Each URL's type is detected automatically.
query	string	Keyword for product search, e.g. women shoes. Runs alongside any startUrls.
maxResults	integer	Max records saved — products and articles together. Each record is one billed result. Default 20; 0 = no limit.
includeProductDetails	boolean	When true (default), each product carries its description, every color and size with its UPC barcode, the full image gallery, and complete review stats. Turn off for faster listing-level records.
proxy	object	Required. Apify Proxy or custom proxy URLs. Residential / country US recommended.

Advanced — accepted in the JSON input, not shown in the form:

Field	Type	Description
maxPages	integer	Listing pages per source. Default 0 = no page limit, so maxResults decides when to stop; set 1 to take the first page of each of many sources.
maxRequestsPerCrawl	integer	Hard cap on HTTP requests, as a safety net. Default 0 = no cap.
minResults	integer	Fail the run if fewer records are produced (handy for live smoke tests).
maxConcurrency	integer	Concurrent requests. Default 3.
debugSaveHtml	boolean	Development only: save every fetched response to the key-value store.

Legacy fields. scrapeType, categoryIds, trendingUrls, and newsUrls are still accepted so existing tasks and API calls keep working, but they are no longer needed — put every URL in startUrls. When scrapeType is set, startUrls are still all used, but only the legacy input matching it is added (e.g. search adds query and ignores trendingUrls and newsUrls).

🔗 Supported URL types

Paste any of these into Start URLs:

Type	Example
Product detail	https://www.macys.com/shop/product/vince-camuto-womens-button-front-collared-shirt-dress?ID=27633829
Category / listing (with its ?id=)	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 listing (newsroom page)	https://www.macysinc.com/newsroom/news/default.aspx
News article	https://www.macysinc.com/newsroom/news/news-details/2026/Macys-Unwraps-the-Magic-of-Holiday-Gifting/default.aspx

A category URL needs its ?id= parameter: Macy's refuses a category page without it, and the run fails with a message saying so. The Macy's Inc. newsroom page builds its article list in the browser, so it is read through the press-release feed: you get the latest press releases, not the newsroom's archive. Purely editorial featured pages (no product grid) may legitimately return no products.

📤 Output

Each dataset item follows the schema in .actor/dataset_schema.json. Both examples are real records from a run on 2026-11-10, shortened where marked …. Product example (abridged):

{
    "type": "product",
    "source": {
        "id": "27633829",
        "canonicalUrl": "https://www.macys.com/shop/product/vince-camuto-womens-button-front-collared-shirt-dress?ID=27633829",
        "retailer": "macys",
        "language": "en-US",
        "currency": "USD"
    },
    "scrapeContext": { "type": "category", "listUrl": "browse:/shop/womens-clothing/womens-dresses:5449" },
    "title": "Women's Floral-Print Short-Sleeve Midi Shirt Dress",
    "brand": "Vince Camuto",
    "description": "This floral-print shirt dress from Macy's has a polished button-front shape with a point collar and hip…",
    "categories": ["Women's Fashion, Shoes & Accessories", "Dresses"],
    "price": {
        "sale": 6672,
        "list": 13900,
        "previous": 13900,
        "currentFormatted": "$66.72",
        "listFormatted": "$139.00",
        "previousFormatted": "$139.00",
        "stockStatus": "InStock"
    },
    "stats": {
        "rating": 4.4,
        "reviewCount": 34,
        "ratingRange": 5,
        "ratingPercentage": 88,
        "recommendedCount": 11,
        "notRecommendedCount": 0,
        "ratingDistribution": [ { "rating": 5, "count": 25 }, { "rating": 4, "count": 5 }, { "rating": 2, "count": 1 }, { "rating": 1, "count": 3 } ],
        "secondaryRatings": [
            { "id": "OverallSize", "label": "Runs Small/Runs Large", "value": 3.75, "valueLabel": "neutral", "minLabel": "Runs Small", "maxLabel": "Runs Large", "range": 7 },
            …
        ],
        "reviewSources": ["BV"]
    },
    "details": {
        "features": ["Imported", "Point collar", "Button closures at front", "Pockets at hips", "Lined"],
        "sizeAndFit": ["Approx. model height is 5'10\" and she is wearing a size small", "Approx. 52\" long"],
        "materialsAndCare": ["82% lyocell, 18% nylon; lining: 100% polyester", "Machine wash"],
        "specialSizes": ["Regular"],
        "bullets": ["Approx. model height is 5'10\" and she is wearing a size small", "Approx. 52\" long", …]
    },
    "options": [
        {
            "type": "Color",
            "values": [
                { "id": "11356735", "name": "Denim Navy", "swatchIcon": { "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/1/optimized/38518361_fpx.tif" } }
            ]
        },
        { "type": "Size", "values": [ { "id": "0", "name": "XS" }, { "id": "1", "name": "S" }, { "id": "2", "name": "M" }, … ] }
    ],
    "variants": [
        {
            "id": "58636889",
            "sku": "199607656984",
            "options": ["Denim Navy", "XS"],
            "price": { "stockStatus": "InStock" },
            "extraInfo": { "upc": "199607656984" }
        },
        {
            "id": "58636891",
            "sku": "199607656960",
            "options": ["Denim Navy", "S"],
            "price": { "stockStatus": "InStock" },
            "extraInfo": { "upc": "199607656960" }
        },
        …
    ],
    "medias": [
        { "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/9/optimized/39372089_fpx.tif", "alt": "39372089.fpx", "index": 0 },
        { "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/4/optimized/38497144_fpx.tif", "alt": "38497144.fpx", "index": 1 },
        …
    ],
    "extraInfo": { "topLevelCategory": "Women's Fashion, Shoes & Accessories" }
}

News example (abridged):

{
    "type": "article",
    "source": {
        "id": "https://www.macysinc.com/newsroom/news/news-details/2026/macys-unwraps-the-magic-of-holiday-gifting/default.aspx",
        "canonicalUrl": "https://www.macysinc.com/newsroom/news/news-details/2026/Macys-Unwraps-the-Magic-of-Holiday-Gifting/default.aspx",
        "retailer": "macys",
        "language": "en-US",
        "publishedUTC": 1793073600000
    },
    "scrapeContext": { "type": "news", "listUrl": "https://www.macysinc.com/rss/pressrelease.aspx" },
    "title": "Macy’s Unwraps the Magic of Holiday Gifting",
    "subtitle": "Macy’s brings the magic to every list with expertly curated gift ideas, beloved traditions and easy ways to shop all season long",
    "publishedAt": "October 27, 2026",
    "category": "Press Release",
    "summary": "Macy’s brings the magic to every list with expertly curated gift ideas, beloved traditions and easy ways to shop all…",
    "bodyText": "Macy’s brings the magic to every list with expertly curated gift ideas, beloved traditions and easy ways to shop all season long NEW YORK--(BUSINESS WIRE)--…",
    "images": [ { "type": "Image", "url": "https://mms.businesswire.com/media/20261027779685/en/2948690/4/Macy%E2%80%99s_112_ct._t.w._labgrown_diamond_earrings_in_14k_white_or_yellow_gol%2C_2%2C500.jpg", "alt": "Macy’s 112 ct. t.w. labgrown diamond earrings in 14k white or yellow gold, $2,500.", "index": 0 } ]
}

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.
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 (6672 = $66.72). list is the regular price. On a markdown, sale is the marked-down price (the lowest one when only some colors or sizes are reduced) and previous the original; both are absent at full price.
price.*Formatted	string	Display strings ("$66.72"). currentFormatted is the price a shopper pays now; previousFormatted appears only with previous.
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.

⚙️ Tips & advanced options

• Use residential US proxies. Product details are intermittently rate-limited; retryOnBlocked + Apify residential session rotation gets through cleanly. Datacenter IPs are more likely to see 403s.
• Keep concurrency modest. The default maxConcurrency of 3 (JSON input only) is the sweet spot. Higher values raise rate-limit rates without improving throughput.
• Smoke test first. Set maxResults: 10 (and minResults: 1 in the JSON input) to confirm your input before a full crawl.
• maxResults is shared by all sources. Sources fill it in order, so the first ones can use it all up. To sample the first page of each of many categories instead, set maxPages: 1 in the JSON input.
• Turn off Full product details (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. No account and 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.

Which URL does each record carry? Output canonicalUrl is always the public product/article page a shopper would visit.

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 or a search query for guaranteed product results.

Can I scrape multiple surfaces in one run? Yes. Put any mix of product, category, trending, and news URLs in startUrls, optionally alongside a query — every one of them is used.

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.

---

🤖 Use with AI agents

This Actor is callable as a tool by any MCP-capable agent — Claude, Cursor, VS Code — or by your own code, with no wrapper and nothing extra to deploy.

Connect over MCP

https://mcp.apify.com?tools=autofacts/macy-s-scraper

In a client that reads an mcpServers configuration block:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=autofacts/macy-s-scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

The agent reads this Actor's parameters and their descriptions straight from the input schema, and the hosted server infers the result field types from the dataset schema — so a model knows what to send and what comes back before it ever calls anything.

Or call the API directly

curl -X POST "https://api.apify.com/v2/acts/autofacts~macy-s-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"startUrls": [{"url": "https://www.macys.com/shop/featured/dresses"}], "maxResults": 20}'

The response body is the dataset records described above.

🧰 Other Actors by autofacts

Apify only auto-recommends Actors in the same category, so here are the ones that actually pair with this scraper:

Actor	What it's for
Sephora Product Scraper	Beauty across 29 countries
Ulta Beauty Scraper	US beauty retail — prices, every shade, reviews
Boohoo Scraper	Fast fashion across 7 regions
Farfetch Scraper	Luxury fashion, multi-currency
Lululemon Scraper	Activewear catalog and pricing

All of them: apify.com/autofacts