Walmart Scraping API
This page describes a hosted API for pulling Walmart search listings and individual product records as structured JSON.
It is aimed at price monitoring, product research and competitor analysis, and it handles the proxy, browser and anti-bot work so your code only sends a query and reads a response.
What the API returns
The service exposes two endpoints. The search endpoint takes a query and returns a page of matching products plus facet counts. The product endpoint takes a Walmart product ID and returns a detailed record for that item. Both return JSON rather than raw HTML, so downstream parsing is a matter of reading named fields instead of writing selectors.
A search response carries a meta_data block (source URL, total results, products per page, page number and total pages), a products array, a facets block for brands, price ranges and ratings, and a location block for ZIP code and store ID. Each product entry includes position, product_id, title, price, currency, rating, review_count, availability, image, url, brand, seller and shipping flags.
A product response is deeper: current and original price with a discount percentage, availability with delivery options, an image list, a specifications object, a rating object with a star distribution, seller details and shipping information.
Choosing between search and product
Use the search endpoint when you need a list of candidates for a keyword, a category sweep or a price comparison across many items. Use the product endpoint when you already know the Walmart product ID and need specifications, review distribution or delivery options for that single item.
A practical checklist before you send a request:
- Do you have a keyword or a product ID? Keyword goes to search; product ID goes to product.
- Do you need localized pricing? Add delivery_zip or store_id.
- Do you need to narrow a large result set? Add min_price, max_price or sort_by on the search call.
- Do you need to emulate a phone or tablet layout? Set device; the default is desktop.
- Do you need the full parameter list? The documentation link covers parameters beyond the ones shown here.
Reading a sample search response
The captured sample uses the query iphone 15 with ZIP code 10001. The meta_data block reports 1,000 total results, 40 products on page 1 and 25 total pages. The first product entry has product_id 5491199371, a price of 1099.99 USD, a rating of 4.7 from 892 reviews, availability "In stock", brand Apple and seller Walmart, with free_shipping and two_day_shipping both true.
The facets block shows how the result set breaks down: brand counts (Apple 245, Samsung 189), price-range buckets and star-rating counts. The location block shows zip_code and store_id as null in this sample, which tells you the response was not pinned to a specific store or ZIP. If you need store-level pricing, pass delivery_zip or store_id explicitly and check that the location block reflects them.
This example is a captured reference, not a live price. Walmart prices and availability change constantly, so treat any number here as illustrative and re-query before acting on it.
Request inputs at a glance
Search endpoint inputs:
- search — the product or keyword to look up.
- delivery_zip — a ZIP code for localized results.
- store_id — a Walmart store ID for localized inventory and pricing.
- sort_by — order by relevance, price, rating and similar.
- min_price and max_price — price filters.
- device — desktop, mobile or tablet emulation; desktop is the default.
Product endpoint inputs:
- product_id — the Walmart product ID to retrieve.
- store_id — localized inventory and pricing.
- delivery_zip — localized results.
Both endpoints accept an Authorization header carrying a bearer API key. The exact request shapes and response schemas are supplied as protected contract modules and should be treated as the source of truth for field names and types.
Two different failures to watch for
When a Walmart scrape fails, the cause usually falls into one of two buckets, and they need different responses.
Anti-bot blocking shows up as CAPTCHAs, rate-limit responses or fingerprint challenges. The fix is infrastructure: rotating proxies, headless browser rendering and CAPTCHA handling. A hosted API is meant to absorb this layer so your code does not manage it.
Layout drift shows up as a successful HTTP response with missing or shifted fields. The fix is schema maintenance: your parser or extraction rules need updating when the page structure changes. Because this API returns named JSON fields rather than raw HTML, layout drift is less likely to break your pipeline, but you should still validate that expected keys are present and non-null after any change in response shape.
A quick triage rule: if the status code is an error or a challenge page, suspect blocking; if the status code is fine but fields are empty, suspect drift or a changed parameter.
Localized pricing and availability
Walmart shows different prices and stock depending on where the shopper is. The API exposes this through delivery_zip and store_id. Passing a ZIP code returns results as they would appear for that delivery area; passing a store ID returns inventory and pricing tied to that store.
If you omit both, expect a generic result set and a location block with null values. If you pass one, check the location block in the response to confirm the API applied it. For multi-region monitoring, run the same query with different ZIP codes and compare the price fields rather than assuming a single national price.
A minimal integration workflow
- Create an account and get an API key.
- Send a GET request to the search or product endpoint with the bearer key in the Authorization header.
- Read the JSON response and map fields into your own store.
- Schedule repeat calls for price monitoring, and diff the price and availability fields between runs.
- Validate that expected keys are present after any response-shape change.
The API is language-agnostic: any HTTP client works. Code samples are provided for Python, JavaScript, PHP, Ruby, Java and Go, and the exact snippets are supplied as protected contract modules.
Commercial terms
Commercial details for this API are not published on this page. Before committing to a plan, ask the provider directly about the following, and record the answers in your own procurement notes rather than relying on this page as a price list or contract summary. Treat each item as an open question until you have a written answer that applies to your account and billing region.
Legal and compliance notes
Scraping Walmart can be legally complex because it may conflict with Walmart's terms of service. Review the applicable terms and laws for your jurisdiction and use case before running a collection job. The API does not collect or store personal data from scraped sites unless the user explicitly requests it, but you remain responsible for how you use the data you retrieve.
This page is a technical description of an API, not legal advice. If your use case involves personal data, regulated categories or redistribution of Walmart content, get your own legal review.
| Aspect | Search endpoint | Product endpoint |
|---|---|---|
| Primary input | search keyword | product_id |
| Localization inputs | delivery_zip, store_id | store_id, delivery_zip |
| Filtering | min_price, max_price, sort_by | not listed |
| Device emulation | device (desktop default) | not listed |
| Response shape | meta_data, products, facets, location | product_id, title, description, price, availability, images, specifications, rating, seller, shipping |
| Typical use | candidate discovery, price comparison | single-item detail, specs, review distribution |
Inputs and response fields reflect the captured reference; confirm the full parameter list in the documentation before relying on any field not shown here.
| Block | Field | Meaning |
|---|---|---|
| meta_data | url | source search URL |
| meta_data | number_of_results | total matching results |
| meta_data | number_of_products | products on this page |
| meta_data | page | current page number |
| meta_data | total_pages | total pages available |
| products[] | position | rank in the result list |
| products[] | product_id | Walmart product identifier |
| products[] | price / currency | listed price and currency |
| products[] | rating / review_count | average rating and number of reviews |
| products[] | availability | stock status string |
| products[] | brand / seller | brand and seller names |
| products[] | free_shipping / two_day_shipping | shipping flags |
| facets | brands / price_ranges / ratings | count breakdowns for filtering |
| location | zip_code / store_id | applied localization, null if none |
Field names are shown exactly as captured; the protected schema module is authoritative for types and requiredness.
Frequently asked questions
Is scraping Walmart legal?
It can be legally complex because it may conflict with Walmart's terms of service. Review the applicable terms and laws for your jurisdiction and use case, and use the API's settings responsibly. This is not legal advice.
Does Walmart block web scrapers?
Yes. Walmart uses anti-bot systems such as CAPTCHAs, IP rate limiting and browser fingerprinting. A hosted API is designed to handle these with rotating proxies, headless browsers and CAPTCHA solving so your requests are less likely to be blocked.
How do I scrape Walmart product data?
Send a request to the search endpoint with a keyword, or to the product endpoint with a Walmart product ID. The API returns structured JSON with product details, pricing, reviews, ratings and availability. Add delivery_zip or store_id if you need localized results.
Can I scrape Walmart prices?
Yes. The API returns current price, original price and discount information. Make sure your use case complies with Walmart's terms of service and applicable laws, and re-query before acting on any price because values change frequently.
What is the difference between the search and product endpoints?
The search endpoint returns a page of matching products plus facet counts for a keyword. The product endpoint returns a detailed record for one product ID, including specifications, review distribution and delivery options.
How do I get store-specific pricing?
Pass store_id for store-level inventory and pricing, or delivery_zip for delivery-area results. Check the location block in the response to confirm the localization was applied.
{
"meta_data": {
"url": "https://www.walmart.com/search?q=iphone15",
"number_of_results": 1000,
"number_of_products": 40,
"page": 1,
"total_pages": 25
},
"products": [
{
"position": 1,
"product_id": "5491199371",
"title": "Apple iPhone 15 Pro Max, 256GB, Natural Titanium - Unlocked (Renewed Premium)",
"price": 1099.99,
"currency": "USD",
"rating": 4.7,
"review_count": 892,
"availability": "In stock",
"image": "https://i5.walmartimages.com/seo/...",
"url": "https://www.walmart.com/ip/Apple-iPhone-15-Pro-Max-256GB/5491199371",
"brand": "Apple",
"seller": "Walmart",
"prime": false,
"free_shipping": true,
"two_day_shipping": true
},
...
],
"facets": {
"brands": [
{"name": "Apple", "count": 245},
{"name": "Samsung", "count": 189},
...
],
"price_ranges": [
{"min": 0, "max": 50, "count": 120},
{"min": 50, "max": 100, "count": 85},
...
],
"ratings": [
{"stars": 4, "count": 350},
{"stars": 3, "count": 125},
...
]
},
"location": {
"zip_code": null,
"store_id": null
}
}
{
"product_id": "5491199371",
"title": "Apple iPhone 15 Pro Max, 256GB, Natural Titanium - Unlocked (Renewed Premium)",
"description": "Example post details.",
"price": {
"current": 1099.99,
"original": 1299.99,
"currency": "USD",
"discount_percentage": 15.4
},
"availability": {
"in_stock": true,
"quantity": null,
"delivery_options": {
"standard": "3-5 business days",
"express": "1-2 business days",
"pickup": "Available today"
}
},
"images": [
"https://i5.walmartimages.com/seo/image1.jpg",
"https://i5.walmartimages.com/seo/image2.jpg",
...
],
"specifications": {
"brand": "Apple",
"model": "iPhone 15 Pro Max",
"storage": "256GB",
"color": "Natural Titanium",
...
},
"rating": {
"average": 4.7,
"count": 892,
"distribution": {
"5": 645,
"4": 180,
"3": 45,
"2": 15,
"1": 7
}
},
"seller": {
"name": "Walmart",
"id": "walmart",
"rating": null
},
"shipping": {
"free": true,
"price": 0,
"two_day": true
}
}