Endpoint Playground
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.
14 Oct 2026: Single record response; 19 fields had a value in every checked item.
Sample value profiles: regular_price: 99.99; name: “Onyx Collection Toiletry Bag”; url: macys.com.
curl 'https://api.crawlora.net/api/v1/macys/product/20518101' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| productId (path) | string | Yes | 20518101 | Numeric Macy's product id, from a product page's ?ID= query parameter |
{
"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"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.