# Walmart Product Search

Search Walmart's product catalog with query text, pagination, sorting, price filters, category filters, and facet filters. Returns product cards with US item ID, title, price, rating, reviews, seller, availability, thumbnail, and product page URL. Results are paginated with a has_more signal.

- **Documentation:** [https://scrappa.co/docs/walmart-api/walmart_search](https://scrappa.co/docs/walmart-api/walmart_search)
- **API group:** Walmart API
- **Endpoint:** `GET https://scrappa.co/api/walmart/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search query text, e.g. coffee maker. |
| `page` | integer | No | Page number, 1-indexed. Default: 1. |
| `sort` | string | No | Sort order: best_match, price_low, price_high, rating_high, new. Default: best_match. |
| `min_price` | integer | No | Minimum price filter in USD. |
| `max_price` | integer | No | Maximum price filter in USD. |
| `cat_id` | string | No | Walmart category ID for browsing within a category. |
| `facet_filter` | string | No | Facet filter string for brand, rating, or other facets. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. This response is not billable. |  |
|  | Walmart did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)