Walmart API endpoint
Returns the reviews snapshot embedded in a Walmart product page: average rating, total review count, the per-star rating breakdown, the recommended percentage, the top positive and top negative review, and a sample of recent reviews. This is a single on-page snapshot, not a full paginated feed. A product that exists but has no reviews returns zero counts and an empty reviews list.
/walmart/product/{item_id}/reviewsPath parameters:
item_id (required) — Walmart item id (the numeric id in a /ip/{id} URL), e.g. 5689919121.Notable response behavior:
reviews list (200), not an error.average_rating is the overall 0–5 rating; recommended_percent is the percentage of reviewers who recommend the product (0–100).rating_counts is the per-star review-count distribution (five_star…one_star).rating, title, text, author, submission_date, positive_feedback, negative_feedback, and review_id. top_positive_review / top_negative_review use the same review shape.503.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| rating | 10 | 1 to 5, median 1 |
| text | 10 | |
| author | 10 | |
| submission_date | 10 | |
| review_id | 10 | |
| title | 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| item_id (path) | string | Yes | Walmart item id (the numeric id in a /ip/{id} URL) | 5689919121 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/walmart/product/5689919121/reviews" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"item_id": "6543706564",
"average_rating": 4.3,
"total_review_count": 2452,
"reviews_with_text_count": 1345,
"recommended_percent": 87,
"rating_counts": {
"five_star": 1698,
"four_star": 273,
"three_star": 150,
"two_star": 116,
"one_star": 215
},
"top_positive_review": {
"rating": 5,
"title": "Great sound",
"text": "The noise cancellation is great!",
"author": "MusicFan",
"submission_date": "11/30/2025",
"review_id": "406499690"
},
"reviews": [
{
"rating": 5,
"text": "Love these earbuds.",
"author": "MusicFan",
"submission_date": "11/30/2025",
"review_id": "406499690"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/walmart.reviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | walmart.ReviewsResponse | No | ||||
| data.average_rating | number | No | 4.3 | Average star rating of the product, out of 5. | ||
| data.item_id | string | No | 5689919121 | Walmart item id the reviews belong to. | ||
| data.rating_counts | object | No | Number of ratings the product received at each star level. | |||
| data.rating_counts.five_star | integer | No | 1698 | Number of 5-star ratings on the product. | ||
| data.rating_counts.four_star | integer | No | 273 | Number of 4-star ratings on the product. | ||
| data.rating_counts.one_star | integer | No | 215 | Number of 1-star ratings on the product. | ||
| data.rating_counts.three_star | integer | No | 150 | Number of 3-star ratings on the product. | ||
| data.rating_counts.two_star | integer | No | 116 | Number of 2-star ratings on the product. | ||
| data.recommended_percent | number | No | 87 | Percentage of reviewers who recommend the product. | ||
| data.reviews | array | No | Sample of recent customer reviews shown on the product page. | |||
| data.reviews[].author | string | No | MusicFan | Nickname of the reviewer. | ||
| data.reviews[].negative_feedback | integer | No | 1 | Number of shoppers who voted the review not helpful. | ||
| data.reviews[].positive_feedback | integer | No | 12 | Number of shoppers who voted the review helpful. | ||
| data.reviews[].rating | number | No | 5 | Star rating the reviewer gave, out of 5. | ||
| data.reviews[].review_id | string | No | 406499690 | Walmart review id. | ||
| data.reviews[].submission_date | string | No | 11/30/2025 | Date the review was submitted, as Walmart shows it, for example `11/30/2025`. | ||
| data.reviews[].text | string | No | Body text of the review. | |||
| data.reviews[].title | string | No | Great sound | Headline the reviewer gave the review. | ||
| data.reviews_with_text_count | integer | No | 1345 | Number of reviews that include written text. | ||
| data.top_negative_review | object | No | Most helpful critical review Walmart highlights. Omitted when there is none. | |||
| data.top_negative_review.author | string | No | MusicFan | Nickname of the reviewer. | ||
| data.top_negative_review.negative_feedback | integer | No | 1 | Number of shoppers who voted the review not helpful. | ||
| data.top_negative_review.positive_feedback | integer | No | 12 | Number of shoppers who voted the review helpful. | ||
| data.top_negative_review.rating | number | No | 5 | Star rating the reviewer gave, out of 5. | ||
| data.top_negative_review.review_id | string | No | 406499690 | Walmart review id. | ||
| data.top_negative_review.submission_date | string | No | 11/30/2025 | Date the review was submitted, as Walmart shows it, for example `11/30/2025`. | ||
| data.top_negative_review.text | string | No | Body text of the review. | |||
| data.top_negative_review.title | string | No | Great sound | Headline the reviewer gave the review. | ||
| data.top_positive_review | object | No | Most helpful positive review Walmart highlights. Omitted when there is none. | |||
| data.top_positive_review.author | string | No | MusicFan | Nickname of the reviewer. | ||
| data.top_positive_review.negative_feedback | integer | No | 1 | Number of shoppers who voted the review not helpful. | ||
| data.top_positive_review.positive_feedback | integer | No | 12 | Number of shoppers who voted the review helpful. | ||
| data.top_positive_review.rating | number | No | 5 | Star rating the reviewer gave, out of 5. | ||
| data.top_positive_review.review_id | string | No | 406499690 | Walmart review id. | ||
| data.top_positive_review.submission_date | string | No | 11/30/2025 | Date the review was submitted, as Walmart shows it, for example `11/30/2025`. | ||
| data.top_positive_review.text | string | No | Body text of the review. | |||
| data.top_positive_review.title | string | No | Great sound | Headline the reviewer gave the review. | ||
| data.total_review_count | integer | No | 2452 | Total number of reviews on the product. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/walmart/product/5689919121/reviews" \
-H "x-api-key: $CRAWLORA_API_KEY"