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契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/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.
MCPツール macys_product
/macys/product/reviewsReturns 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.
レスポンスに関する注記
- `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.
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.
MCPツール macys_suggest
関連API
Marketplaces & Retail
Separate a site-search result from a live auction or completed sale, and use BaT's own make and model directory to carry valid IDs into result and price-history requests.
Marketplaces & Retail
Treat Glovo as a local marketplace: discover the supported city first, then follow that city's category, store, menu, and collection identifiers through the catalog.
Marketplaces & Retail
Use PetSmart's hierarchical paths to scope product searches, then keep product SKU, price range, online availability, pickup eligibility, and store inventory as separate fields.
対象企業
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.
On 2026-10-30 reviews for product 15041387 reported total_reviews 1,224 across 123 pages of 10, average_rating 4.4967 and recommended_ratio 0.868, and suggestions for dress returned 10 terms.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Macy's のデータを JSON として取得できます。Macy's に対応するスキル:
Looks up a Macy's product's full detail and customer reviews by its numeric productId, and pulls Macy's own search-box (typeahead) suggestions…
npx skills add github.com/Crawlora-org/crawlora-skills --skill macys-researchResearch products, prices, sellers, and reviews across major online marketplaces and retailers, including African Jumia storefronts. Use when the…
npx skills add github.com/Crawlora-org/crawlora-skills --skill product-price-researchFAQ
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.