# Walmart Category Browse

Products of one category page with sort, facet filter (for example brand:Samsung) and pagination, in the same item shape as Walmart Product Search. Reports the real last page and total. Walmart serves at most 25 pages per category. Category slugs and ids come from the categories endpoint. Works for walmart.com and walmart.ca (category ids differ between the two sites). Paid placements are removed so pages do not overlap. For sort=price_low or price_high the page is ordered by price when Walmart returns it out of order; search_metadata.sort_applied says server or page, and ordering applies within the returned page. A category without products, or one that Walmart serves as a content page, answers 404. A page past the last page is an empty list. Both cost nothing. Costs 1 credit per successful request with items. Failed requests are free.

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

## 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 |
| --- | --- | --- | --- |
| `slug` | string | Yes | Category slug, e.g. electronics. |
| `category_id` | string | Yes | Category id, e.g. 3944. |
| `page` | integer | No | Page number, 1-indexed. Default: 1. Walmart serves at most 25 pages. |
| `sort` | string | No | best_match (default), price_low, price_high, rating_high, new. |
| `facet` | string | No | Facet filter name:value, e.g. brand:Samsung. |
| `country` | string | No | Marketplace: us (walmart.com, default) or ca (walmart.ca). |

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