# Walmart Reviews API (https://www.socialcrawl.dev/platforms/walmart/reviews)

> Returns written customer reviews for a Walmart product, up to 50 per call, each with the full review text, star rating, author, date, helpful-vote count, verified-purchase flag, and any reviewer photos. Sortable by relevancy, recency, or rating, and filterable to a single star rating. Note that consecutive pages can repeat a small number of reviews when sorting by recency, because the underlying review feed shifts between calls; de-duplicate by review id when crawling.

TL;DR: `GET /v1/walmart/reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | yes | Walmart product id, numeric or alphanumeric. The same id accepted by GET /v1/walmart/product. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `limit` | no | Reviews per page, 1 to 50. Defaults to 10. |
| `sort` | no | Review ordering: relevancy (default), recent, rating_high_low, or rating_low_high. (relevancy \| recent \| rating_high_low \| rating_low_high) |
| `rating` | no | Return only reviews with this exact star rating, 1 to 5. |
| `country` | no | Walmart marketplace as a two-letter country code: US (walmart.com, default) or CA (walmart.ca). A product id from one marketplace will not resolve in the other. (US \| CA) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/walmart/reviews?product_id=17835006350" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How many Walmart reviews come back per call?

Up to 50, which is the maximum the review feed exposes per page. At 5 credits per call that is 0.1 credit per review, and you can page through the full review history for a product using the standard cursor parameter.

### Can I filter to only one-star or five-star reviews?

Yes. Pass a rating between 1 and 5 to return only reviews with that exact star rating, which is the fastest way to mine complaints or testimonials without paging the whole feed. You can also sort by relevancy, recency, or rating.

### How do I know whether a review is from a real purchaser?

Each review carries a verified flag that is true only when Walmart marks it as a verified purchase. Reviewer badges also cover things like top-reviewer status and incentivised reviews, and we read only the genuine purchase signal into the verified field.

### Can consecutive pages return the same review twice?

Occasionally, yes, when sorting by recency, because Walmart's review feed shifts between calls. De-duplicate by review id when crawling. Every review row carries a stable id specifically so this is easy.

### What if a product has no written reviews?

You get an empty list and the credits are refunded, so scanning a catalogue for reviewable products costs nothing on the misses. Note that a product can have thousands of star ratings but far fewer written reviews.

See the full Walmart API: https://www.socialcrawl.dev/platforms/walmart

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to scrape Walmart product reviews with an API
- Walmart API to export customer reviews and ratings