# Walmart Deals

Deals listings: the deals page, or rollback, clearance and reduced price items for a keyword. Item shape matches Walmart Product Search; was_price is null when absent and out_of_stock is null when Walmart sends no stock status. The keyword is required for rollback, clearance and reduced_price. Costs 1 credit per request that returns items. Failed requests and pages past the end are free.

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

## 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 |
| --- | --- | --- | --- |
| `type` | string | No | deals (default), rollback, clearance, reduced_price. |
| `query` | string | No | Keyword. Required unless type is deals, e.g. tv. |
| `page` | integer | No | Page number, 1-indexed. Default: 1. Walmart serves at most 25 pages. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Walmart has no page for this request. This response is not billable. |  |
|  | 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)