Walmart Suggest API

OverviewLink to Overview

Return search autocomplete suggestions from the Walmart.com typeahead — the same query expansions shoppers see while typing in the search bar.

Walmart injects suggestions dynamically after JavaScript runs. Piloterr uses website rendering to load walmart.com in a browser, trigger the typeahead for your keyword, and return structured suggestion objects with display labels, thumbnail images, and internal query strings.

Pair this endpoint with Walmart Search (full results page) and Walmart Product (PDP details) to build a complete discovery pipeline.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/walmart/suggest?query=apples

With optional ZIP localization:

GET https://api.piloterr.com/v2/walmart/suggest?query=apples&zipcode=95829

Or via POST:

POST https://api.piloterr.com/v2/walmart/suggest
Content-Type: application/json

{"query": "apples"}

ParametersLink to Parameters

Response fieldsLink to Response fields

WorkflowLink to Workflow

1. Suggest — discover related queries from a partial keyword
2. Search — pass https://www.walmart.com/search?q=<term> to get product cards
3. Product — pass any result /ip/ URL for full PDP data

NotesLink to Notes

• Returns query-level suggestions, not full product listings.
• zipcode is optional — omit it when you only need generic query suggestions.
• When provided, the ZIP code affects localized store and inventory context on walmart.com.
• Build the search URL from a suggestion: https://www.walmart.com/search?q=<display_name>.
• Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

• Power typeahead UIs with live Walmart search suggestions
• Discover high-intent query expansions from partial keywords
• Feed keyword research and SEO pipelines for US grocery and retail
• Localize suggestion context by ZIP code when store-level intelligence is needed