~ / endpoints / Filters & Facets API

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.

Get a free API keyBrowse the endpoints
1,000
free requests / mo
2.6s
median response
facets + sorts
per query
JSON
structured output

Quickstart

cURL
curl "https://api.walmartscraperapi.com/api/v1/walmart/filters?query=laptop&api_key=$API_KEY"
Python
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

200 OK
{
  "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
    }
  ]
}
FieldTypeDescription
querystringThe search term you passed as query.
filtersarrayEvery facet available for the query.
filters[].namestringThe filter label, e.g. Brand or Price.
filters[].typestringThe control type, e.g. checkbox or range.
filters[].valuesarrayEach option with its name, id, and result count.
sort_optionsarrayAvailable sort orders with id, url, and the selected flag.

Params

ParameterRequiredDefaultNotes
queryrequired-The Walmart search term whose filters and sorts you want.
api_keyrequired-Your API key, passed as a query parameter. Get one free at signup.

Use it for

>

Catalog taxonomy

Map the full facet tree behind a query to model a category the way Walmart does.
>

Dynamic filter UIs

Feed your own storefront filters with Walmart facet names, values, and counts.
>

Segment sizing

Read the count on each value to size brands, price bands, and attributes.
>

Sort research

Capture the available sort options to mirror or benchmark result ordering.

Pricing

PlanPriceBest for
Free1,000 requestsTesting and small jobs
Pro$0.60 / 1kProduction workloads
Pay-as-you-go$0.90 / 1kSpiky 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.

Get filters & facets api as JSON
Free plan, 1,000 requests. No credit card required.
Get a free API key All endpoints