Get Macy's prices, promotions and UPC-level stock with one API
Macy's US product, price, promotion and UPC-level stock data API returns live Macy's US product, price, promotion and UPC-level stock data data as clean JSON for macy's us product, price, promotion and upc-level stock data The primary endpoint, search, returns total (the retailer's own count), product_ids[], products[] with id and url, page, page_size (read from the answer, 60 on every full page….
6 active endpoints, on 1, 2 and 3 credit tiers.
- POST/macys/v1/search
- POST/macys/v1/product/detail
- POST/macys/v1/products/batch
- POST/macys/v1/product/reviews
- POST/macys/v1/products/list
- POST/macys/v1/categories
What Macy's US product, price, promotion and UPC-level stock data endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Macy's US product, price, promotion and UPC-level stock data API
6 of 6 endpoints, ready to run
Search the US catalogue by keyword and get Macy's own result total plus the product ids on the page. Page size was 60 on every full page measured, and the answer carries last_page and has_more so a crawl knows when to stop. Resolve the ids with products/batch or product/detail.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Macy's US product, price, promotion and UPC-level stock data API works
Macy's US product, price, promotion and UPC-level stock data is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 438 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Track a keyword's prices across Macy's, in three calls
Search gives you ids and Macy's own total; batch turns fifty of them into full records for 3 credits, a thirty-third of what fifty single lookups cost; detail fills in the three fields batch does not carry. This is the shape every price-tracking job ends up in.
{ "query": "kitchenaid mixer" }Returns Macy's own result count and the product ids on the page. If the total is larger than the page, page through it — every page carries last_page and has_more, and one page past the end you get past_last_page with zero rows.
{ "ids": [ ...up to 50 ids from step 1... ] }One request, 3 credits. Each product comes back with its full USD price band, discount percentage, promotion blocks and every variant's UPC, stock and shipping fees. Ids Macy's has no record for are listed in missing_ids.
{ "id": "77589" }Call this only for the products you need the category path, the review summary or the loyalty-card offer on — the three fields Macy's multi-id form does not publish.
A priced, barcoded, in-stock-aware view of a whole keyword for a handful of credits, with every id resolvable and every omission named.
curl -X POST https://api.reefapi.com/macys/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"nike air max"}'{
"ok": true,
"data": { … },
"meta": {
"api": "macys",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Measured against the live gateway
Each row is a figure from the verification run, including the ones that are not flattering. A page where every number looks good is a page nobody should trust.
Macy's US storefront only, prices read and returned in USD, never converted
1,121,654 product ids in Macy's own published feed, across 23 shards (22 of exactly 50,000, one of 21,654)
6,636 published category and brand pages with ids
Up to 50 in one request — 3 credits against 100 for fifty single lookups
60 products per full page, read from each answer rather than assumed; partial pages come back shorter and say so
Pages 1, 2 and 3 of three different results: 165, 180 and 180 products with zero overlap
14 of 14 products agreed in the last run
14 of 14 per-colour prices fell inside the published band; 0 outside
129 of 129 variant rows carried a 12-digit UPC, each with its own stock, shipping fees and delivery days
9 of 36 — both ends are returned, with a price_is_range flag
9 of 36; a discount percentage on 8 of 36. Most Macy's products are simply not on sale
9 of 36 — most products have no reviews yet
28 of 36 on product/detail; the multi-id form does not publish it at all
The category path, the review summary and the loyalty-card offer — null and named in omitted_fields, not silently absent
Returned exactly as Macy's publishes them, and false on every product measured; they appear to need a store context this surface is not given
Facets are returned with their counts but are not accepted as filters, because none was measured actually narrowing a result
What people build with Macy's US product, price, promotion and UPC-level stock data
The jobs this data is most often used for.
endpoints
credits per call
Pricing teams use Macy's US product, price, promotion and UPC-level stock data to search the US catalogue by keyword, or list a whole category by its id.
Marketplace operators use Macy's US product, price, promotion and UPC-level stock data to get full published record for one Macy's product.
Catalog enrichment teams use Macy's US product, price, promotion and UPC-level stock data to get price, promotion, stock and UPC data for up to 50 products in ONE upstream call.
Retail analysts use Macy's US product, price, promotion and UPC-level stock data to get a page of published customer reviews for one product, with rating, title, body, author nickna….
What Macy's US product, price, promotion and UPC-level stock data data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 438 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/macys/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"nike air max"}'import requests
r = requests.post(
"https://api.reefapi.com/macys/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "nike air max"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Macy's US product, price, promotion and UPC-level stock data.
Get a free key →What is the Macy's US product, price, promotion and UPC-level stock data API?▾
Macy's US product, price, promotion and UPC-level stock data API is a ReefAPI endpoint group for macy's us product, price, promotion and upc-level stock data It returns live JSON through POST requests under /macys/v1.
Is the Macy's US product, price, promotion and UPC-level stock data API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Macy's US product, price, promotion and UPC-level stock data calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Macy's US product, price, promotion and UPC-level stock data login or account?▾
No login to Macy's US product, price, promotion and UPC-level stock data is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Macy's US product, price, promotion and UPC-level stock data data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Macy's US product, price, promotion and UPC-level stock data API use?▾
Macy's US product, price, promotion and UPC-level stock data actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Macy's US product, price, promotion and UPC-level stock data from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call macys actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Macy's US product, price, promotion and UPC-level stock data API a Macy's US product, price, promotion and UPC-level stock data scraper?▾
It is the managed alternative to a DIY Macy's US product, price, promotion and UPC-level stock data scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same macy's us product, price, promotion and upc-level stock data back as clean JSON.
Why does my Macy's US product, price, promotion and UPC-level stock data scraper keep getting blocked?▾
Most Macy's US product, price, promotion and UPC-level stock data scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.
191 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Macy's US product, price, promotion and UPC-level stock data, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 437 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-03.