Walmart Autocomplete

Return Walmart search suggestions and category suggestions for a partial query with limit and timeout controls.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
query / q	string	Required	Partial Walmart search query.
limit	number	Optional	Maximum suggestions to return (1-20).
timeout_ms	number	Optional	Provider timeout in milliseconds (3000-30000).

Response fields

Field	Type	Description
success	boolean	Whether autocomplete completed successfully.
suggestions	array	Keyword suggestions with position, keyword, URL, image URL, and type when exposed.
categories	array	Category suggestion rows with title, URL, and image URL when exposed.
time_taken	number	API response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/walmart/autocomplete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "football",
  "limit": 8
}'

Example response

{
  "success": true,
  "source": "walmart",
  "query": "football",
  "count": 3,
  "time_taken": 0.51,
  "suggestions": [
    {
      "position": 1,
      "keyword": "football",
      "url": "https://www.walmart.com/search?q=football"
    },
    {
      "position": 2,
      "keyword": "football gloves",
      "url": "https://www.walmart.com/search?q=football+gloves"
    }
  ],
  "categories": [
    {
      "position": 1,
      "title": "Football",
      "url": "https://www.walmart.com/cp/football/..."
    }
  ]
}