> **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>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/walmart.mdx>

---

# Walmart API. Products, prices and reviews as JSON.

Look up any Walmart product with its price, seller and specifications, page through its reviews, and search or browse the catalogue by category. Every response uses the same envelope.

- Products + prices
- Reviews
- 1 credit per request

`GET /v1/walmart/product` is the center of the Walmart API. A product carries its brand, model, UPC, category path, rating and review count, the plain-text description, highlights and the full specification table, its images, the price with any earlier price and unit price, stock status, the seller of the shown offer, the best offer in each condition (new, open box, restored), how many offers there are across sellers, and every variant with its price and stock. Pass an item id like `16101019327` or the product page URL.

Around it, `/v1/walmart/product/reviews` pages through what shoppers wrote, ten at a time, with the rating distribution, the topics reviewers mention and a filter by stars. `/search` and `/category/products` return product cards with prices, ratings and sellers, paid placements kept apart, and a cursor. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`; a miss is `not_found`, not an HTTP error.

## What you can get

- Product detail with price, earlier price, unit price, stock, seller, offers by condition, specifications, highlights, images and variants.
- Product reviews with ratings, verified-purchase badges, photos, helpful votes and the variant bought, plus rating distribution and review topics.
- Reviews ordered by relevance, date, rating or helpfulness, and filtered to one star rating.
- Keyword search with prices, ratings, sellers and badges, paid placements kept apart.
- Every product in a category or subcategory, with the category's path.
- Six sort orders on search and category lists, and cursors that continue the same list.

## Walmart endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Product | GET /v1/walmart/product | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/walmart/product/get) |
| Product reviews | GET /v1/walmart/product/reviews | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/walmart/product/reviews/get) |
| Search | GET /v1/walmart/search | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/walmart/search/get) |
| Category products | GET /v1/walmart/category/products | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/walmart/category/products/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Walmart route.
2. **Pick the product, search or category.** Use an item id or URL, for example `GET /v1/walmart/product?productId=16101019327`, a search such as `air fryer`, or a category such as `5427_486190`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. Keep requesting with `page.nextCursor` while `page.hasMore` is true, watch `page.truncated`, and bill from `meta.creditsCharged`.

## Pricing

Each Walmart route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Walmart's own APIs are for its marketplace sellers and registered affiliates. Social Fetch gives every route one JSON shape: prices as numbers with a currency, plain text instead of page markup, typed `lookupStatus` answers and opaque cursors that continue the same list and filters. You do not need an account or a session.

## FAQ

### What Walmart data can I get from the API?

Products with price, seller, offers by condition, specifications, variants and ratings; product reviews with statistics; keyword search; and the products in a category or subcategory, each list with paging. A department Walmart shows only as a landing page, such as Toys, answers with the subcategory ids to use.

### How do I name a Walmart product?

Use its item id, the number at the end of the product page URL such as 16101019327, or the URL itself. An id Walmart doesn't have returns data.lookupStatus: not_found.

### Are prices the same for every shopper?

Prices are numbers in USD. Walmart sets price, stock and delivery by store, so they can differ a little between requests. priceText keeps the price as the site writes it.

### How do I get every review of a product?

Call /v1/walmart/product/reviews and follow page.nextCursor while page.hasMore is true. Each page holds ten reviews and is one request. Filter by star rating with rating and order with sort.

### How far can I page through a search?

Walmart serves the first 400 or so products of a search or category. totalResults says how many match, and page.truncated is true when the list stops before its end. Walmart ranks every request afresh, so the cursor leaves out a product an earlier page returned, and a product that moves up onto a page already read can be missed.

### Can I see every seller's offer for a product?

The product shows the seller of the main offer, the best offer in each condition and offerCount, how many offers there are across sellers. A list of every seller's offer is not offered yet.

### Is a search with no match an error?

No. Search returns lookupStatus: found with an empty products list and totalResults: 0, leaving out the loosely related products Walmart offers instead.

### How much does the Walmart API cost?

Every Walmart route charges a flat amount per completed request, shown on each endpoint page, and each page of a list is billed separately. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Walmart Product API](https://www.socialfetch.dev/platforms/walmart/product): Price, seller, offers and specifications (`GET /v1/walmart/product`).
- [Walmart Product Reviews API](https://www.socialfetch.dev/platforms/walmart/product-reviews): Reviews with ratings, photos and statistics (`GET /v1/walmart/product/reviews`).
- [Walmart Product Search API](https://www.socialfetch.dev/platforms/walmart/search): Keyword search with prices, ratings and sellers (`GET /v1/walmart/search`).
- [Walmart Category Products API](https://www.socialfetch.dev/platforms/walmart/category-products): Every product in a category (`GET /v1/walmart/category/products`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Walmart question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Walmart tools from Cursor or Claude with the same credit metering as REST.
