# Walmart Product Reviews

Customer reviews of one Walmart product, 10 per page, with sort order, a single star filter, per-review photos, rating histogram, aspects and review summary. A page past the last page returns an empty list with the real total. Works for walmart.com and walmart.ca. Only reviews with text are listed; rating-only reviews appear in the histogram counts. Costs 1 credit per successful request. Failed requests are free.

- **Documentation:** [https://scrappa.co/docs/walmart-api/walmart_reviews](https://scrappa.co/docs/walmart-api/walmart_reviews)
- **API group:** Walmart API
- **Endpoint:** `GET https://scrappa.co/api/walmart/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Walmart item id (us_item_id). Digits on walmart.com, alphanumeric on walmart.ca. |
| `page` | integer | No | Page number, 1-indexed. Default: 1. Walmart serves at most 200 pages. |
| `sort` | string | No | relevancy (default), helpful, submission-desc, submission-asc, rating-desc, rating-asc. |
| `rating` | integer | No | Only reviews with this star rating, 1 to 5. |
| `country` | string | No | Marketplace: us (walmart.com, default) or ca (walmart.ca). |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Walmart has no page for this request. This response is not billable. |  |
|  | A public parameter is invalid. This response is not billable. |  |
|  | Walmart did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)