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

---

# Walmart Product Search API

Search Walmart's catalogue by keyword and read prices, ratings and sellers for every result.

`GET /v1/walmart/search?query=air%20fryer` returns `products`, about 40 a page, each with `id`, `name`, `url`, `imageUrl`, `price`, `wasPrice`, `unitPriceText`, `rating`, `reviewCount`, `sellerName`, `availability` and `badges`. Paid placements come apart in `sponsoredProducts`, and `relatedSearches` lists the searches the site suggests.

Order with `sort` (`relevance`, `bestselling`, `top_rated`, `newest`, `price_high_to_low`, `price_low_to_high`) and follow `page.nextCursor` while `page.hasMore` is true. Walmart serves the first 400 or so results of a search: `totalResults` counts every match and `page.truncated` is true when the list stops before its end.

## Request

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

## FAQ

### Why are sponsored products separate?

Walmart repeats paid placements on every page, so they come apart in sponsoredProducts and products holds the ranked results.

### Can a product show up twice, or be missed, across pages?

Walmart ranks every request afresh, so products move between pages while you walk a search. The cursor remembers the products earlier pages returned and leaves out a repeat. A product that moves up onto a page you already read can be missed. Walking lego over nine pages, 69 of 360 rows were repeats left out, so expect a walk to miss some products too.

### How deep can I page?

About ten pages, the depth Walmart serves. The last page reports page.truncated: true when more products match than any page can reach.

### How many searches can I run?

Walmart guards its search pages more closely than its product and category pages, so search runs at a low rate: about eight pages a minute, shared by every caller. Searches sent together wait their turn, so a few at once are served one after another. One that cannot be served within the request's time answers 503 temporarily_unavailable, saying search is rate-limited, and is not charged; retry after the seconds in its Retry-After header. For steady volume, list a category's products instead, which has no such limit.

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

No. It returns lookupStatus: found with an empty products list and totalResults: 0. The loosely related products Walmart offers instead are left out.

### 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.
