Endpoint Playground
Test Crawlora's Macy's Product Reviews API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/macys/product/reviews?product_id=<product_id>" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| product_id | string | Yes | Numeric Macy's product id, from a product page's ?ID= query parameter | |
| page | integer | No | Result page, 1-based, defaults to 1 |
{
"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"
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns 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.
{
"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"
}
]
}
}curl "https://api.crawlora.net/api/v1/macys/product/reviews?product_id=<product_id>" \
-H "x-api-key: $CRAWLORA_API_KEY"