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.
GET https://api.piloterr.com/v2/walmart/suggest?query=apples
Avec localisation ZIP optionnelle :
GET https://api.piloterr.com/v2/walmart/suggest?query=apples&zipcode=95829
Ou en POST :
POST https://api.piloterr.com/v2/walmart/suggest
Content-Type: application/json
{"query": "apples"}
Paramètre
Type
Requis
Description
query
string
oui
Mot-clé partiel ou complet (ex. apples)
zipcode
string
non
Code postal US optionnel (5 chiffres) pour le contexte magasin
Field
Type
Description
results
array
Autocomplete suggestions returned by Walmart
results[].display_name
string
Label shown in the typeahead dropdown
results[].url
string
Internal query string (e.g. query=applesauce&typeahead=apples)
results[].type
string
Suggestion type (typically QUERY)
results[].image_url
string
Thumbnail image for the suggested category or product
results[].analytics_fm
number
Walmart analytics metadata attached to the suggestion
Suggest — discover related queries from a partial keyword
Search — pass https://www.walmart.com/search?q=<term> to get product cards
Product — pass any result /ip/ URL for full PDP data
Returns query-level suggestions, not full product listings.
zipcode est optionnel — omettez-le pour des suggestions génériques.
S'il est fourni, le code postal influence le contexte magasin sur walmart.com.
Build the search URL from a suggestion: https://www.walmart.com/search?q=<display_name>.
Costs 2 credits per call (browser rendering).
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
Localiser le contexte des suggestions par code postal si besoin
Il s'agit d'une API non officielle. Piloterr est un fournisseur de données indépendant et n'est ni affilié, ni approuvé, ni sponsorisé par Piloterr ou ses propriétaires. Toutes les marques appartiennent à leurs propriétaires respectifs.