Walmart Filters & Facets Scraper API
Our Walmart filters scraper returns the full facet and sort structure behind any Walmart search as JSON: every filter, its type, and its values with result counts, plus the available sort options.
Quickstart
curl "https://api.walmartscraperapi.com/api/v1/walmart/filters?query=laptop&api_key=$API_KEY" import requests, os
BASE = "https://api.walmartscraperapi.com"
API_KEY = os.environ["API_KEY"]
data = requests.get(
f"{BASE}/api/v1/walmart/filters",
params={"query": "laptop", "api_key": API_KEY},
timeout=30,
).json()
for row in data["results"]:
print(row) Response
{
"query": "laptop",
"filters": [
{
"name": "Brand",
"type": "checkbox",
"values": [
{
"name": "HP",
"id": "brand:HP",
"count": 420
},
{
"name": "Lenovo",
"id": "brand:Lenovo",
"count": 356
}
]
},
{
"name": "Price",
"type": "range",
"values": [
{
"name": "$200 - $300",
"id": "price:200-300",
"count": 180
}
]
}
],
"sort_options": [
{
"name": "Best Match",
"id": "best_match",
"url": "/search?q=laptop",
"selected": true
},
{
"name": "Price low to high",
"id": "price_low",
"url": "/search?q=laptop&sort=price_low",
"selected": false
}
]
} | Field | Type | Description |
|---|---|---|
query | string | The search term you passed as query. |
filters | array | Every facet available for the query. |
filters[].name | string | The filter label, e.g. Brand or Price. |
filters[].type | string | The control type, e.g. checkbox or range. |
filters[].values | array | Each option with its name, id, and result count. |
sort_options | array | Available sort orders with id, url, and the selected flag. |
Params
| Parameter | Required | Default | Notes |
|---|---|---|---|
query | required | - | The Walmart search term whose filters and sorts you want. |
api_key | required | - | Your API key, passed as a query parameter. Get one free at signup. |
Use it for
Catalog taxonomy
Dynamic filter UIs
Segment sizing
Sort research
Pricing
| Plan | Price | Best for |
|---|---|---|
| Free | 1,000 requests | Testing and small jobs |
| Pro | $0.60 / 1k | Production workloads |
| Pay-as-you-go | $0.90 / 1k | Spiky or one-off volume |
Median response 2.6s. You only pay for successful requests.
FAQ
What is a Walmart filters scraper?
It reads the facet and sort structure that Walmart renders for a search and returns it in a structured format. Our API takes a search query and returns every filter, its type, and its values with result counts, plus the sort options, as JSON.
What input does it take?
Pass the search term in the query parameter. The endpoint reads the search result page and returns its filters and sort options.
What is in each filter?
Each filter carries a name, a type such as checkbox or range, and a values array where every value has a name, an id, and a result count.
Does it return products too?
This endpoint focuses on the filter and sort structure. For the ranked products themselves, use the Walmart search endpoint.
How fast is the API?
Median end-to-end response is about 2.6 seconds, including proxy routing, anti-bot handling, retries, and parsing.