Walmart Search Autocomplete — API reference

POST

Available

/walmart/autocomplete

Walmart Search Autocomplete

Retrieve Walmart search suggestions for a query. This endpoint does not retrieve a Walmart product page.

type

walmart_autocomplete

result

schemas.source_data

Billing

1 credits

Retrieve Walmart search suggestions for a query. This endpoint does not retrieve a Walmart product page.

Parameters

FieldTypeAvailabilityDescription

query

sample

string

Catalog sample; the API validates required fields.

sample: "laptop"

country

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

cursor

optional

string

optional

Public alias for pagination.cursor. Use one spelling at a time; the API validates the parameters and values supported by this product.

device

optional

string

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

gl

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

hl

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

html

optional

boolean

optional

Public alias for include_html. Use one spelling at a time; the API validates the parameters and values supported by this product.

language

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

limit

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

markdown

optional

boolean

optional

Public alias for include_markdown. Use one spelling at a time; the API validates the parameters and values supported by this product.

mobile

optional

boolean

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

num

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

page

optional

integer

optional

Public alias for pagination.page. Use one spelling at a time; the API validates the parameters and values supported by this product.

q

optional

string

optional

Public alias for query. Use one spelling at a time; the API validates the parameters and values supported by this product.

json

{
  "query": "laptop"
}

Open in Playground

The response follows this product's contract; no recorded response example is published yet.schemas.source_data

Code and response examples

bash

curl -X POST 'https://api.serpbase.dev/walmart/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"laptop"}'

Notes

Use the catalog sample to get started, then inspect the actual JSON response.

The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.