> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/walmart/product-reviews>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/walmart/product-reviews.mdx>

---

# Walmart Product Reviews API

Page through the reviews of any Walmart product, sorted and filtered the way you need.

`GET /v1/walmart/product/reviews?productId=16101019327` returns ten `reviews` a page, each with `rating`, `title`, `text`, `submittedAt`, the reviewer's nickname, `isVerifiedPurchaser`, `helpfulCount`, `photos`, the seller and the variant bought (`features`). `stats` carries the average rating, the review count, the rating distribution, the share of reviewers who recommend the product and the topics reviewers mention most.

Order with `sort` (`relevance`, `newest`, `oldest`, `highest_rating`, `lowest_rating`, `most_helpful`) and keep one star rating with `rating`. Follow `page.nextCursor` while `page.hasMore` is true. An id Walmart does not have returns `lookupStatus: not_found`; a product without reviews is `found` with an empty list.

## Request

- **Endpoint:** `GET /v1/walmart/product/reviews`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by item id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/walmart/product/reviews/get)
- **Platform page:** [/platforms/walmart](https://www.socialfetch.dev/platforms/walmart)

## FAQ

### How many reviews come in a page?

Ten, Walmart's own page size. totalResults says how many reviews match the filters, and page.nextCursor continues the same list.

### Why is totalResults lower than reviewCount?

stats.reviewCount counts every rating, including ratings left without text. The list pages through reviews with text, which totalResults counts.

### Can I read only the negative reviews?

Yes. Pass rating=1 or rating=2, or sort=lowest_rating to read every review from the lowest rating up.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
