Endpoint Playground
Returns a product's aggregate star-rating breakdown (average, total, and per-star counts) and up to item_count written reviews, optionally sorted and/or filtered to one star rating. A product with no reviews yet (e.g. a pre-order) returns a null ratings summary and an empty reviews list, not an error.
14 Oct 2026: Single record response; 2 fields had a value in every checked item; 1 field was empty in this sample.
Sample value profiles: total_reviews: 0.
curl 'https://api.crawlora.net/api/v1/xbox/reviews?product_id=BT5P2X999VH2&order_by=MostHelpful' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| product_id | string | Yes | BT5P2X999VH2 | Xbox catalog product id |
| item_count | integer | No | Number of reviews to return (1-25) | |
| order_by | string | No | MostHelpful | Review sort order |
| star_filter | integer | No | Only return reviews with this exact star rating (1-5); omit for all ratings | |
| locale | string | No | Display locale (BCP-47) |
{
"code": 200,
"msg": "OK",
"data": {
"product_id": "BT5P2X999VH2",
"ratings": {
"average_rating": 3.3,
"total_count": 226178,
"star1_count": 82702,
"star2_count": 8799,
"star3_count": 9863,
"star4_count": 12807,
"star5_count": 112007
},
"total_reviews": 91078,
"reviews": [
{
"review_id": "abc",
"title": "Great",
"text": "Fun game",
"rating": 5,
"user_name": "Foo",
"helpful_positive": 10,
"helpful_negative": 1,
"submitted_date_time": "2024-04-19T18:53:50.895337",
"device_family": "Windows.Xbox"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.