Retail pricing and sale monitoring
Macy'sエンドポイントを使えば、「Retail pricing and sale monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn a Macy's product page into structured retail data — name, brand, department/division, category breadcrumb, sale-aware pricing, availability, images, and every purchasable color variant with its own price — then page its customer reviews with a site-wide rating histogram. All normalized JSON, credential-free.
Get full Macy's product detail, paginated customer reviews with a rating histogram, and search-box suggestions — as structured JSON.
エンドポイントファミリー
2
ドキュメント化されたパラメータ
7
サンプル数
3
ライブカタログスナップショット
稼働エンドポイント
3
メソッド
GET
必須パラメータ
6
スキーマ参照
3
{
"platform": "Macy's",
"endpoint": "macys-product",
"method": "GET",
"path": "/macys/product/{productId}",
"auth": "apiKey"
}ユースケース
Get full Macy's product detail, paginated customer reviews with a rating histogram, and search-box suggestions — as structured JSON.
Macy'sエンドポイントを使えば、「Retail pricing and sale monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Macy'sエンドポイントを使えば、「Product catalog research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Macy'sエンドポイントを使えば、「Color-variant price tracking」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のMacy'sエンドポイントカタログから取得しています（エンドポイント3件、ドキュメント化されたリクエストパラメータ7個、公開レスポンススキーマ3件）。DocsとPlaygroundが参照しているカタログと同じものです。
Macy'sのエンドポイントは3件、2つのリクエストファミリーに分類されています（Product、Suggest）。
これらのMacy'sエンドポイントには7個のリクエストパラメータがドキュメント化されており、うち6個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
3件のMacy'sエンドポイントのうち3件が実際のサンプルレスポンスを、3件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Macy'sのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Macy'sのエンドポイントは3個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/macys/product/{productId}
/macys/suggest
エンドポイントカタログ
/macys/product/{productId}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.
レスポンスに関する注記
- `regular_price` and `current_price` are both the full price when the product is not on sale, and diverge when `on_sale` is `true` (`current_price` is what a shopper actually pays). - `colors` lists every purchasable color of the base product, each with its own `regular_price`/`current_price`/`on_sale` -- colors can be priced or on sale independently of each other and of the product-level price. A product with no color axis (single-SKU) returns an empty `colors` array. - `rating` and `review_count` are the product's aggregate review statistics; both are `0` when the product has no reviews yet. - `images` is the product's full image gallery as absolute URLs. - An unrecognized `productId` returns `404`. A non-numeric or missing `productId` returns `400` before any upstream request is made. Example response: ```json {"code":200,"msg":"OK","data":{"product_id":"20518101","name":"Onyx Collection Toiletry Bag","brand":"CHAMPS","description":"Introducing the Toiletry Bag from the Onyx Collection...","bullet_points":["Approximate dimensions: 11\" L x 4.25\" W x 6.25\" H","3-way zip closure for easy, versatile access and added security."],"department_name":"TRADITIONAL LUGGAGE","division_name":"LUGGAGE","categories":["Upright Luggage"],"available":true,"low_availability":false,"currency_code":"USD","regular_price":99.99,"current_price":39.99,"on_sale":true,"rating":4,"review_count":4,"images":["https://slimages.macysassets.com/is/image/MCY/products/2/optimized/31299222_fpx.tif"],"colors":[{"id":"9824974","name":"Black","regular_price":99.99,"current_price":39.99,"on_sale":true}],"url":"https://www.macys.com/shop/product/champs-onyx-collection-toiletry-bag?ID=20518101"}} ```
MCPツール macys_product
/macys/product/reviewsReturns one page of a Macy's product's normalized customer reviews, plus a site-wide rating summary (rating count, average rating, recommended ratio, rating histogram) for the product. Sourced from a separate review platform Macy's own product pages embed, distinct from the product catalog itself. 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.
レスポンスに関する注記
- `rating_count`, `average_rating`, `recommended_ratio`, and `rating_histogram` are the product's site-wide aggregate rating summary, not just this page. `rating_histogram` is the count of ratings per star, ascending: index 0 is 1-star, index 4 is 5-star. - Some reviews carry only a star rating with no written title/body (`ratings_only: true`); `title` and `body` are omitted for those. - A product with zero reviews, or a well-formed but unrecognized `product_id`, returns a normal, empty result (`count: 0`, `total_reviews: 0`) rather than an error -- the review source does not distinguish an unknown product id from a real, reviewless product. - A malformed `product_id` returns `400` before any upstream request is made. Example response: ```json {"code":200,"msg":"OK","data":{"product_id":"15041387","page":1,"page_size":10,"total_pages":113,"total_reviews":1128,"rating_count":1065,"average_rating":4.52,"recommended_ratio":0.87,"rating_histogram":[79,17,47,50,872],"count":10,"source_url":"https://api.bazaarvoice.com/data/reviews.json?...","fetched_at":"2026-08-11T10:00:00Z","reviews":[{"id":"256498189","rating":5,"recommended":true,"ratings_only":false,"title":"Creed Aventus","body":"I love Creed Aventus this is my second bottle. I get a lot of compliments on this. Highly recommend this cologne.","author":"Rudyh1999","submitted_at":"2026-08-07T15:08:26Z"}]}} ```
MCPツール macys_product_reviews
/macys/suggestReturns 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.
レスポンスに関する注記
- There is no pagination -- `suggestions` is a single flat list (up to 10 entries). - A partial query with no real matches returns a normal, empty result (`count: 0`, empty `suggestions`) rather than an error. Example response: ```json {"code":200,"msg":"OK","data":{"query":"dress","count":10,"suggestions":["dresses","womens summer dresses","wedding guest dresses","women petite dresses","women formal dresses","donna karan dresses","women cocktail dresses","womens plus size dresses","calvin klein dresses","adrianna papell dresses"],"source_url":"https://www.macys.com/suggester?...","fetched_at":"2026-08-12T10:00:00Z"}} ```
MCPツール macys_suggest
関連API
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
対象企業
Macy's, Inc. · M
Macy'sを運営するのはMacy's, Inc.（M）です。CrawloraのSECエンドポイントは同じ企業のCIKを受け取るため、提出書類・財務・インサイダー取引・13F保有を上記のMacy'sエンドポイントと同じAPIキーで取得できます。
SEC提出書類・財務API →Macy'sのスクレイピング方法
Crawlora covers Macy's in three endpoints — search-box typeahead, full product detail, and paginated customer reviews — all returned as normalized JSON with one API key and no Macy's account.
Send a partial query to /macys/suggest for Macy's own typeahead — up to 10 suggested search phrases. This is phrase discovery, not a product search: the response carries no product data or IDs.
Macy's has no product-search or category-listing endpoint, so take the numeric productId from a Macy's product page's ?ID= query parameter (the same id that appears as product_id in every response).
Pass that productId to /macys/product/{productId} for name, brand, department/division, category breadcrumb, bullet points, availability, images, and pricing. regular_price and current_price are equal off-sale and diverge when on_sale is true.
colors lists each purchasable colour with its own regular_price/current_price/on_sale, so one colour can be discounted while its siblings are not — read the variant, not just the base product, when tracking markdowns.
Call /macys/product/reviews with the same product_id and page through the reviews. Each page also carries the site-wide summary: total_reviews, average_rating, recommended_ratio, and rating_histogram — counts per star, ascending, index 0 = 1-star and index 4 = 5-star.
FAQ
Not for products. /macys/suggest returns Macy's own search-box phrases (a flat list of up to 10 suggestions, no pagination and no product data), but there is no product-search or category-listing endpoint. Source productId values from Macy's product page URLs — the numeric ?ID= query parameter — rather than from a Crawlora search call.
Yes. regular_price and current_price are both the full price when the product is not on sale and diverge once on_sale is true, with current_price being what a shopper actually pays. Every colour variant repeats that same trio, so variant-level markdowns are visible too.
Pass a numeric product_id to /macys/product/reviews and page through the results. Alongside the reviews themselves you get the product's site-wide aggregate — rating count, average rating, recommended ratio, and a five-bucket rating histogram — on every page, so you can read the rating distribution without fetching all pages.
Macy's collects star-only ratings as well as written reviews. Those arrive with ratings_only set and no title or body, which is why total_reviews and the rating_count in the summary do not always match — one counts submissions, the other counts scored ratings.
No Macy's account or login is required from the caller — only your Crawlora API key. Macy's runs its storefront as a Nuxt.js single-page app behind Akamai Bot Manager, so the product data is hydrated client-side rather than present in the initial HTML; Crawlora returns the resolved JSON instead of leaving you to render it.