Extract product listing cards from any Walmart.com search results page (walmart.com/search). Pass a full search URL copied from the browser and receive structured results with titles, prices, unit prices, ratings, review counts, seller info, stock status, sponsorship flags, and pagination metadata.
Walmart search pages are JavaScript-driven single-page applications. Product cards and sponsored placements are rendered client-side after the page loads. Piloterr uses website rendering to open the search URL in a browser, wait for listings to appear, and extract structured JSON from the rendered page.
Use each result's url with the Walmart Product endpoint for full PDP data (specs, fulfillment, badges, images).
GET https://api.piloterr.com/v2/walmart/search?query=https://www.walmart.com/search?q=apples
Or via POST:
POST https://api.piloterr.com/v2/walmart/search
Content-Type: application/json
{"query": "https://www.walmart.com/search?q=apples"}
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Walmart search URL from walmart.com |
| Format |
Example |
| Keyword search |
https://www.walmart.com/search?q=apples |
| Paginated search |
https://www.walmart.com/search?q=apples&page=2 |
| Filtered search |
Any walmart.com /search URL with sort, category, or facet params |
| Field |
Type |
Description |
results |
array |
Product cards from the search results page |
results[].us_item_id |
string |
Walmart numeric item ID |
results[].id |
string |
Internal Walmart product identifier |
results[].name |
string |
Product title |
results[].url |
string |
Full product page URL (/ip/) |
results[].canonical_url |
string |
Relative product URL path |
results[].image |
string |
Product thumbnail URL |
results[].price |
number |
Numeric price when available |
results[].price_info.line_price_display |
string |
Formatted shelf price (e.g. $8.97) |
results[].price_info.unit_price |
string |
Unit price label (e.g. $2.99/lb) |
results[].average_rating |
number |
Average customer rating |
results[].number_of_reviews |
number |
Total review count |
results[].seller_name |
string |
Seller display name |
results[].availability_status_v2.value |
string |
Stock status code (e.g. IN_STOCK) |
results[].is_sponsored_flag |
boolean |
Whether the listing is a sponsored placement |
results[].fulfillment_type |
string |
Fulfillment mode (e.g. STORE) |
pagination.page |
number |
Current page number |
pagination.total |
number |
Total matching products |
pagination.max_page |
number |
Maximum page available |
pagination.next |
boolean |
Whether a next page exists |
- Suggest: discover query expansions from a partial keyword + ZIP
- Search: scrape the search results page for product cards (this endpoint)
- Product: fetch full PDP JSON from any result
url
- Always pass the full search URL copied from walmart.com (not just the keyword).
- Paginate by updating
page= in the URL (e.g. &page=2).
- Results may include sponsored listings (
is_sponsored_flag: true).
- Costs 2 credits per call (browser rendering).
- Monitor Walmart search rankings and sponsored placement for target keywords
- Build US retail price intelligence pipelines from live search pages
- Discover product URLs and
us_item_id values at scale
- Track competitor visibility across category and keyword searches
