Walmart API
The Walmart API returns Walmart.com product data as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns products with item id, name, brand, price, list price, savings, rating, review count, availability, seller and category, and you can pull a product_detail, reviews and the category tree. It is the managed alternative to a Walmart scraper — no proxies, no captcha handling — for price intelligence, catalog enrichment and review analysis. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/walmart/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "laptop"
}
}{
"ok": true,
"meta": {
"api": "walmart",
"endpoint": "search",
"mode": "live",
"latency_ms": 5618.6,
"record_count": 45,
"bytes": 1306915,
"cache_hit": false,
"stop_reason": "limit_reached",
"method": "real_chrome_mint_curl_replay",
"currency": "USD",
"total": 17389,
"count": 45,
"page": 1,
"max_page": 13,
"query": "laptop",
"attempts": 1
},
"data": {
"results": [
{
"item_id": "[redacted-phone]",
"name": "[redacted-name]",
"brand": null,
"type": "VARIANT",
"url": "https://www.walmart.com/ip/Acer-Chromebook-315-15-6-Full-HD-1920-x-1080-Laptop-Intel-Processor-N50-4GB-RAM-128GB-eMMC-Elemental-Blue-CB315-7H-C7F8-ChromeOS/[redacted-phone]?classType=VARIANT",
"price": 199,
"list_price": 229,
"savings_amount": 30,
"price_display": "Now $199.00",
"currency": "USD",
"rating": 4.3,
"review_count": 106,
"availability": "IN_STOCK",
"seller": "Walmart.com",
"category": "Electronics",
"image": "https://i5.walmartimages.com/seo/Acer-Chromebook-315-15-6-Full-HD-1920-x-1080-Laptop-Intel-Processor-N50-4GB-RAM-128GB-eMMC-Elemental-Blue-CB315-7H-C7F8-ChromeOS_c04f78e1-31a3-4b41-946e-a3b7a[redacted-phone]fc198bee510d726b354f91acd5.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"sponsored": true
},
{
"item_id": "[redacted-phone]",
"name": "[redacted-name]",
"brand": null,
"type": "REGULAR",
"url": "https://www.walmart.com/ip/Lenovo-IdeaPad-Slim-3-15-Laptop-AMD-Ryzen-3-8GB-RAM-256GB-SSD-Artic-Grey/[redacted-phone]?classType=REGULAR",
"price": 399,
"list_price": null,
"savings_amount": 0,
"price_display": "$399.00",
"currency": "USD",
"rating": 4.6,
"review_count": 523,
"availability": "IN_STOCK",
"seller": "Walmart.com",
"category": "Electronics",
"image": "https://i5.walmartimages.com/seo/Lenovo-IdeaPad-Slim-3-15-Laptop-AMD-Ryzen-3-8GB-RAM-256GB-SSD-Artic-Grey_7953cac8-b606-40c8-9db1-722d9ab37b50.5b36b97cda83d6830df2c5c904c9b467.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"sponsored": true
},
{
"item_id": "[redacted-phone]",
"name": "[redacted-name]",
"brand": null,
"type": "REGULAR",
"url": "https://www.walmart.com/ip/Pryloxen-Laptop-Windows-11-Pro-15-6-Intel-3050E-CPU-Home-Computer-16GB-RAM-1TB-SSD-Pink/[redacted-phone]?classType=REGULAR&athbdg=L1800",
"price": 339.99,
"list_price": 448.99,
"savings_amount": 109,
"price_display": "Now $339.99",
"currency": "USD",
"rating": 4.4,
"review_count": 9,
"availability": "IN_STOCK",
"seller": "Kutoda Laptops",
"category": "Electronics",
"image": "https://i5.walmartimages.com/seo/Pryloxen-Laptop-Windows-11-Pro-15-6-Intel-3050E-CPU-Home-Computer-16GB-RAM-1TB-SSD-Pink_c1e1ec7c-f23c-4b43-af84-e6574387fb92.f88368982cdcb0c5b48bd31c2119365b.png?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"sponsored": true
}
],
"total": 17389,
"count": 45,
"page": 1,
"max_page": 13
}
}What the Walmart API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Walmart.com by keyword → a paginated, sortable list of products with item id, name, current & list price, savings, star rating + review count, availability, seller, category, fulfillment, image and the product link. Narrow with min_price/max_price and sort. Note: `brand` is a separate field only where Walmart itself splits it out — measured 65/65 on backpacks and 57/57 on sneakers, but 0/53 on laptops and 0/49 on TVs, where Walmart instead carries the brand inside the product name ('HP 14 inch…'). Use product_detail when you need brand as a guaranteed field. | Pricing teams call search to search Walmart.com by keyword → a paginated, sortable list of products with item id, name, cu…. | query, sort, page, max_results, min_price, ... |
| product_detail | Full product record by Walmart item id (or product URL): name, brand, model, UPC, manufacturer part number, current & list price, availability, seller, average rating + review count, short & long descriptions, the full specification table, product highlights, every variant with its resolved attributes (colour/size/…), the category breadcrumb, return policy, fulfillment and the gallery images. | Marketplace operators call product_detail to get full product record by Walmart item id (or product URL). | item_id, url |
| reviews | Customer reviews for a Walmart product by item id (or product URL): the average rating, total review count, recommended-percentage, the 5★→1★ rating distribution and percentages, the most-mentioned aspects, and the review texts (rating, title, body, date, helpful counts, verified-purchase, purchased variant, photos). | Catalog enrichment teams call reviews to get customer reviews for a Walmart product by item id (or product URL). | item_id, url, max_results |
| category | Browse a Walmart category / department by its query term (e.g. 'coffee maker', '4k tv') → the same product grid as search, framed as a category browse with the related category searches surfaced. Paginated and sortable. | Retail analysts call category to get browse a Walmart category / department by its query term (e.g. | query, sort, page, max_results, min_price, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/walmart/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"laptop"}'import requests
r = requests.post(
"https://api.reefapi.com/walmart/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "laptop"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/walmart/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "laptop"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.walmart.search with {"query":"laptop"}.Who uses this API and why
- Pricing teams call search to track Walmart prices, rollbacks and savings against competitors.
- Catalog-enrichment tools use product_detail to fill product pages with specs, images and availability.
- Review-analysis products pull reviews to monitor sentiment and rating trends for an item.
Questions developers ask before integrating
What is the Walmart API?
Walmart API is a ReefAPI endpoint group for walmart It returns live JSON through POST requests under /walmart/v1.
Is the Walmart API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Walmart calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Walmart login or account?
No login to Walmart is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Walmart data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Walmart API use?
Walmart actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Walmart from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call walmart actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Walmart API a Walmart scraper?
It is the managed alternative to a DIY Walmart scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same walmart back as clean JSON.
Why does my Walmart scraper keep getting blocked?
Most Walmart scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.