Walmart API
Eight endpoints for Walmart product search, detail, reviews, buy-box offers, category browse, marketplace sellers and store lookup — each one a single POST returning structured JSON, down to one store's assortment. No seller account, no scraping stack.
50 free credits on signup. No card, no seller account.
{ "data": { "query": "wireless headphones", "url": "https://www.walmart.com/search?q=wireless+headphones", "location": { "city": "Sacramento", "state": "CA", "store_id": "3081", "zipcode": "95829" }, "page": 1, "total_results": 33001, "max_page": 13, "count": 67, "products": [ { "pos": 1, "id": "17760865787", "title": "Bluetooth Headphones Over Ear, 65Hrs Playtime Wireless Headphones", "url": "https://www.walmart.com/ip/...", "price": 29.99, "currency": "USD", "rating": 4.4, "rating_count": 1893, "seller": "MOVSSOU" } ] }, "response_time": 2140, "credits_used": 1, "credits_remaining": 4749}Live call against the real endpoint — 3 free runs, then it's your own key.
What is the Scavio Walmart API?
The Scavio Walmart API is a REST API that returns public Walmart data as structured JSON. You send a keyword, item id, category, seller id or ZIP code to one of 8 POST endpoints with your API key, and get back search results, product detail, customer reviews, the buy-box offer, a category feed, a seller's whole catalogue or the stores near a ZIP - and search or product can be targeted at one store.
- 8
- endpoints, all live in production
- 1
- credit per call (2 on com.mx or one store)
- 0
- seller accounts required
Start with these four
They cover most of what people build. The full eight are below.
Search
POST /api/v1/walmart/searchKeyword search with price, rating, rating count and seller on every row — and the store location the results were priced for.
Product detail
POST /api/v1/walmart/productOne item by id — current price against strikethrough price, rating, full image gallery and specifications.
Reviews
POST /api/v1/walmart/reviewsCustomer reviews with rating, body text, author, date and the verified-purchase flag, paginated.
Seller catalogue
POST /api/v1/walmart/seller-productsEverything a marketplace seller lists, in the same product shape as search — the fastest way to size a competitor.
All 8 Walmart endpoints
Every route is a POST, returns JSON, and takes the same API key. 1 credit per successful call, or 2 against the com.mx marketplace.
| Endpoint | Returns | Credits |
|---|---|---|
Search/api/v1/walmart/search | Item id, title, price, currency, rating, rating count, seller | 1 |
Product detail/api/v1/walmart/product | Price and strikethrough price, rating, image gallery, specs | 1 |
Reviews/api/v1/walmart/reviews | Rating, title, body, author, date, verified-purchase flag | 1 |
Buy-box offer/api/v1/walmart/offers | Price and list price, currency, condition, availability, shipping | 1 |
Category browse/api/v1/walmart/category | A category's products, in the same shape Search returns | 1 |
Seller detail/api/v1/walmart/seller | Legal and storefront name, Pro Seller badge, seller type | 1 |
Seller catalogue/api/v1/walmart/seller-products | A marketplace seller's listings, in the Search product shape | 1 |
Stores by ZIP/api/v1/walmart/stores | Store ids near a US ZIP or Canadian postal code, nearest first | 1 |
50 free credits on signup covers 50 calls of any kind. See plans
Search to reviews in two calls
Find the item, then read what buyers said about it. The response on the right is a real capture, field names and all.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
res = client.walmart.search(query="wireless headphones")
for p in res["data"]["products"]:
print(p["id"], p["price"], p["title"][:40])
# Then reviews for one item - 1 credit
reviews = client.walmart.reviews(item_id="17760865787"){
"data": {
"query": "wireless headphones",
"url": "https://www.walmart.com/search?q=wireless+headphones",
"location": {
"city": "Sacramento",
"state": "CA",
"store_id": "3081",
"zipcode": "95829"
},
"page": 1,
"total_results": 33001,
"max_page": 13,
"count": 67,
"products": [
{
"pos": 1,
"id": "17760865787",
"title": "Bluetooth Headphones Over Ear, 65Hrs Playtime Wireless Headphones",
"url": "https://www.walmart.com/ip/...",
"price": 29.99,
"currency": "USD",
"rating": 4.4,
"rating_count": 1893,
"seller": "MOVSSOU"
}
]
},
"response_time": 2140,
"credits_used": 1,
"credits_remaining": 4749
}Why not Walmart's developer programme?
Walmart's own APIs exist to run a seller account, not to read the public catalogue. They solve a different problem.
Walmart Marketplace / Supplier APIs
- Built for sellers and suppliers managing their own items, orders and inventory
- Requires an approved seller or supplier account tied to a real business relationship
- No open endpoint for competitor listings, reviews or third-party seller catalogues
- Access is scoped to data you already own, not the public storefront
Scavio Walmart API
- One API key, issued at signup — no seller account, no business relationship
- Any public listing, review, category or marketplace seller
- Store-aware pricing, with the resolving store returned in the response
- Same key and JSON envelope as 30 other Scavio platforms
Scavio returns publicly available listing data only, and never authenticates as a Walmart user.
What developers build with it
Price and promotion tracking
Poll an item and watch price against strikethrough price to catch real discounts rather than permanent fake ones. Search results also carry the store the prices were resolved for.
product + offersMarketplace seller intelligence
Resolve a seller, read the Pro Seller badge and seller type, then page their whole catalogue in the same shape as search. The quickest way to size a competitor's Walmart footprint.
seller + seller-productsReview mining
Pull reviews with the verified-purchase flag and run an LLM over the text for defects, sizing complaints and feature requests — on your listings or a rival's.
reviewsCategory and assortment analysis
Browse a category to see what Walmart actually stocks and at what price bands, then diff week over week to spot new entrants and delistings.
category + searchCross-retailer price comparison
Run the same product across Walmart and Amazon with one key and near-identical response shapes, so a comparison table is a join rather than an integration project.
search + Amazon searchAgent tools and shopping assistants
Point an agent at the MCP server and Walmart becomes a callable tool — price-check, compare and summarise listings — with the same key as every other Scavio platform.
MCP + RESTNo code today? Use the free tools
Same endpoints behind them. 5 free runs a day, no account.
How to get Walmart data as JSON
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, with no card required and no Walmart seller or affiliate account needed.
- 2
POST a query or item id
Send {"query": "wireless headphones"} to https://api.scavio.dev/api/v1/walmart/search with an Authorization: Bearer header. Every Walmart endpoint is a POST and takes a query, item id, category or seller id.
- 3
Read the JSON
The response wraps the payload under data, plus credits_used and credits_remaining. Search returns products with page, max_page and total_results, so you page by incrementing page.
Walmart API FAQ
What is the Scavio Walmart API?
+
It is a REST API that returns public Walmart data as structured JSON. Eight POST endpoints cover keyword search, product detail, customer reviews, the buy-box offer, category browse, marketplace seller detail, a seller's full catalogue and store lookup by ZIP code. You authenticate with a Scavio API key.
Who are these endpoints for?
+
Developers embedding retail data in a product; AI agent builders wiring Walmart in as an MCP or SDK tool; automation engineers running it inside n8n, Zapier or Make; ecommerce and pricing teams tracking competitors; brand managers watching marketplace sellers; and analysts sizing categories. Same API for all of them — what changes is which of the 8 endpoints you call.
How much does a Walmart request cost?
+
Walmart endpoints cost 1 credit, with two exceptions: requests against the Mexican marketplace (domain com.mx) cost 2, and a search or product request targeted at one store (store_id + delivery_zip) costs 2. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits.
Does Walmart have an official public API for this?
+
Not for reading the public catalogue. Walmart's developer programme serves marketplace sellers and suppliers managing their own listings and orders, which is a different job. For public product, review and seller data there is no open first-party equivalent.
Are prices store-specific?
+
Yes, and you can choose the store. Call /api/v1/walmart/stores with a US ZIP or Canadian postal code to get nearby store ids, then pass store_id and delivery_zip to search or product to get that store's assortment, price and availability on walmart.com or walmart.ca. Every response includes a location object with city, state, store_id and zipcode, so you always know which store the results came from.
Can I get every listing from one marketplace seller?
+
Yes. Resolve the seller with /api/v1/walmart/seller, then call /api/v1/walmart/seller-products to page their catalogue. It returns the same product shape as search, so the same parsing code handles both.
What does the response look like?
+
The API wraps the payload under a data key and adds credits_used and credits_remaining. A search result carries pos, id, title, url, price, currency, rating, rating_count and seller, alongside query, page, max_page, count, total_results and the location object.
How does pagination work?
+
Search, category and seller-catalogue responses return page, max_page and total_results. Increment page on the next call, and stop when you reach max_page.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints directly with an HTTP client.
Is scraping Walmart data legal?
+
Scavio returns publicly available listing data and does not access private account data or authenticate as a user. You remain responsible for how you use the data, including compliance with Walmart's terms. Talk to your own counsel for your specific use case.
Explore more of Scavio
Amazon API
Search, product detail and every seller offer.
Google API
SERP, Shopping, Maps, News and AI Mode.
Target API
Product search and detail as JSON.
Home Depot API
Product search and detail as JSON.
MCP server
Every platform as a callable tool for agents.
Pricing
Credit packs and plans, no per-platform surcharge.
Start pulling Walmart data today
50 free credits on signup, no card. Your first request is a POST with a keyword in it.