Walmart Search Autocomplete

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

Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.

API reference Open in Playground

At a glance

Endpoint: POST https://api.serpbase.dev/walmart/autocomplete
Price: 1 credits / request
Authentication: X-API-Key
Result type: schemas.source_data

Endpoint and billing rules

POSThttps://api.serpbase.dev/walmart/autocomplete

Per-request cost

1 credits / request

Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.

Example request parameters

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.

Example request parameters
Parameter	Example type	Example value
query	string	"laptop"

JSON

{
  "query": "laptop"
}

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
Alias	Parameter	Type
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string

Supported devices: desktop; default: desktop.

Request examples

cURL

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

JavaScript

const response = await fetch("https://api.serpbase.dev/walmart/autocomplete", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"query\":\"laptop\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Response and API outcome

Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.

View response documentation

Frequently asked questions

How much does the Walmart Search Autocomplete API cost?

Each request costs 1 credit. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.

How do I call the Walmart Search Autocomplete API?

Send a POST request to https://api.serpbase.dev/walmart/autocomplete with your API key in the X-API-Key header. The response is JSON; check status (0 means success).

Which devices does it support?

Supported devices: desktop. The default is desktop.

Is the Walmart Search Autocomplete API available now?

Yes. Any active API key can call it.