# Walmart Search API (https://www.socialcrawl.dev/platforms/walmart/search)

> Returns Walmart search results for a keyword: title, product id, URL, image, rating, review count, availability, seller, and shipping and pickup flags per product, with optional price, location, and store filters. Prices are NOT returned on search results, which is a limitation of Walmart's search surface rather than an omission here; the price field is null and you should call GET /v1/walmart/product with the returned product id when you need pricing. Treat this endpoint as the keyword-to-product-id resolver for the rest of the Walmart API.

TL;DR: `GET /v1/walmart/search` 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 |
| --- | --- | --- |
| `query` | yes | Search keyword or phrase. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `sort_by` | no | Result ordering: best_match (default), price_low, price_high, best_seller, or top_rated. (best_match \| price_low \| price_high \| best_seller \| top_rated) |
| `min_price` | no | Lowest price to include. Must be below max_price when both are set. |
| `max_price` | no | Highest price to include. Must be above min_price when both are set. |
| `zip_code` | no | ZIP code used to localise availability, pickup, and shipping options. Walmart pricing and stock are store-level, so results differ by location. |
| `state` | no | Two-letter US state code used to localise results (for example CA, NY). |
| `store_id` | no | Walmart store id, to restrict results to one physical store's assortment. |
| `facet` | no | Opaque refinement token taken from a previous response's facet data (for example a brand or category filter). |
| `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/search?query=airpods%20pro" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Why is the price null on Walmart search results?

Because Walmart's search surface does not expose prices, and returning zero would be worse than returning nothing: a price monitor would act on a fake zero. Use search to resolve a keyword to a product id, then call the product endpoint for the price, or use the category endpoint, which does return real prices.

### Can I filter search results by price?

Yes. Minimum and maximum price filters are applied by Walmart server-side, so the result set narrows correctly even though the price field itself is not returned on search rows.

### How do I localise results to one store?

Pass a ZIP code, a two-letter US state code, or a specific Walmart store id. Availability, pickup, and shipping options then reflect that location rather than a national default.

### How do I page through more results?

Use the standard cursor parameter, which advances one page at a time. Keep paging until you get an empty list rather than relying on a total, because the reported result count is not a reliable total across pages.

### What happens on a query with no real matches?

Walmart returns its own loosely related suggestions instead of an empty list, exactly as its website does. Check the titles and ratings on the returned rows rather than assuming a non-empty response means a good match.

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 search Walmart products with an API
- Walmart API to find product ids by keyword