Walmart Product Search API — Keyword, Sort & Price Filters
Send a keyword and this source searches Walmart's catalog and returns matching products as data: title, item ID, price, rating and image, with optional sort and price-range filters.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "walmart_product_search",
"keyword": "wireless mouse",
"max_items": 2,
"start_page": 1,
"sort": "best_match",
"min_price": null,
"max_price": null,
"timeout": 300,
"partial": false,
"human": "# Walmart product search\n\n- **Search term:** wireless mouse\n- **Starting page:** 1\n- **Max items:** 2\n- **Sort:** best_match\n- **Records returned:** 2\n- **Response size:** 1.50 MB",
"machine": {
"total_items": 2,
"items": [
{
"id": "10774352381",
"name": "Logitech Precision Pro Wireless Mouse, Black, Compatible with Laptop, PC, Mac, iPadOS, Walmart Exclusive",
"url": "https://www.walmart.com/ip/Logitech-Precision-Pro-Wireless-Mouse/10774352381?classType=REGULAR",
"price": 38.66,
"currency": "USD",
"list_price": null,
"image": "https://i5.walmartimages.com/seo/Logitech-Precision-Pro-Wireless-Mouse_c76cddbf-c8cb-47d0-8e85-4add479ce780.1728b07ccdbdcbcec9c5abf4f7c22987.png?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"rating": 4.5,
"review_count": 247,
"category": "Home Page/Electronics/Computers, Laptops and Tablets/Computer Accessories/Computer Keyboards & Mice/Computer Mouse & Mouse Pads/Wireless Mouse",
"seller": {
"id": "F55CDC31AB754BB68FE0B39041159D63",
"name": "Walmart.com",
"type": null
},
"availability_status": "IN_STOCK",
"is_in_stock": true,
"is_sponsored": true
},
{
"id": "13802306327",
"name": "Logitech Silent Wireless Mouse, Black, Walmart Exclusive",
"url": "https://www.walmart.com/ip/Logitech-Silent-Wireless-Mouse-Black/13802306327?classType=VARIANT&athbdg=L1200",
"price": 14.52,
"currency": "USD",
"list_price": null,
"image": "https://i5.walmartimages.com/seo/Logitech-Silent-Wireless-Mouse-Black_cfe0592c-dd7d-4d65-9af9-52f5bf7bd47e_1.742d532fe35714dd47641a50658a2609.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"rating": 4.5,
"review_count": 5618,
"category": "Home Page/Services/Immersive Shopping Suite/View in 3D",
"seller": {
"id": "F55CDC31AB754BB68FE0B39041159D63",
"name": "Walmart.com",
"type": null
},
"availability_status": "IN_STOCK",
"is_in_stock": true,
"is_sponsored": true
}
],
"response_bytes": 1568313
},
"total_points": 2
}- You send
- A search keyword, with optional sort and price-range filters
- You get back
- Matching products with title, item ID, price, rating and image
- Coverage
- Walmart.com's searchable product catalog.
- Price
- 1 point per returned result, up to 250 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Searching the site by hand | Type the keyword, sort, scroll, copy | Free, and slow | Nobody keeps a category list current this way |
| Building a scraper | Write it, host it, and repair it when Walmart changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, keyword and filters as parameters | $1 per 1,000, misses not billed | A broad keyword returns a broad — and larger, more expensive — result set |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many products were returned in this batch (capped by max_items). |
id | string | Walmart item ID. |
name | string | Listing title. |
url | string | Direct link to the product page. |
price | number | Current listed price. |
currency | string | ISO currency code. |
list_price | number | Pre-discount list price, when the item is on sale. |
image | string | Primary product image URL. |
rating | number | Average star rating. |
review_count | number | Number of reviews. |
category | string | Full category path the listing is filed under. |
seller | object | Seller id, name and type for this listing. |
availability_status | string | Stock status, e.g. IN_STOCK. |
is_in_stock | boolean | Whether the item is currently in stock. |
is_sponsored | boolean | Whether the result is a sponsored placement. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
keyword is the only required field. max_items caps the result count (up to 250, defaults to 25) and sets what you're billed for; sort and min_price/max_price narrow the query before you pay for results.
curl -X POST https://api.neuralverge.ai/functions/v1/run-walmart-product-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "wireless mouse", "max_items": 25, "sort": "best_seller", "min_price": 10 }'What teams use it for
Where this field shows up in an actual workflow.
Pull every listing for a product type and compare price against rating.
See what a category actually contains on Walmart.com, sorted by best seller.
Sort by new and re-run on a schedule to catch fresh listings in a category.
Find item IDs to feed into Walmart product for full detail.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Walmart.com's searchable product catalog.
Searched at request time.
This source returns publicly visible search results, stamped with the keyword it was read from and a session id you can trace.
- —Sponsored placement can affect result order the way it affects the site itself.
- —A broad keyword returns a broad result set — narrow it or you'll pay for noise.
- —Stock and price reflect the moment of the search and can change right after.
Questions, answered
You only get and pay for up to max_items results, so set it deliberately rather than leaving it at the default.
Related sources
Try walmart product search on your own data
One request format across every source in the catalog.