GET/macys/product/{productId}apiKey3 credits/request
Returns one Macy's product's full detail: name, brand, description, department/division, category breadcrumb, pricing (with sale detection), availability, images, aggregate rating, and every purchasable color variant with its own price. productId is a numeric id, taken from a Macy's product page's ?ID= query parameter.
Required: productId.
Sampled 14 Oct 2026: 19 fields returned with a value. In the sample: regular_price: 99.99; name: “Onyx Collection Toiletry Bag”; url: macys.com; available: true; description: 513 characters; bullet_points: 14 entries; brand: “CHAMPS”; department_name: “TRADITIONAL LUGGAGE”.
Open in Playground
GET/macys/product/reviewsapiKey3 credits/request
Returns one page of a Macy's product's customer reviews, plus a site-wide rating summary (rating count, average rating, recommended ratio, rating histogram) for the product. product_id is a numeric id, the same one used by GET /macys/product/{productId}. A product with zero reviews, or a well-formed but unrecognized product_id, returns a normal, empty result rather than an error.
Required: product_id. Optional: page.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, rating, recommended, ratings_only, submitted_at. Not in every item: title (2), body (2), author (5). In the sample: submitted_at: 2026-10-08 to 2026-10-13; rating: 1 to 5, median 5; recommended: true in 0 of 10; ratings_only: true in 8 of 10.
Open in Playground
GET/macys/suggestapiKey3 credits/request
Returns Macy's own search-box suggestions (typeahead) for a partial query: a flat list of suggested search phrases, no product data. A partial query with no real matches returns a normal, empty result rather than an error.
Required: query.
Open in Playground