Walmart API for Product and Review Data
The SurfSense Walmart API scrapes public Walmart.com listings as structured JSON: price and list price, rating and review count, availability, 1P and marketplace sellers, variants, and specifications. A second verb pages the full public review history — ratings, text, authors, verified-purchase flags, images, and seller responses. Point your AI agents at a search term or product URL — no login, only public data.
Prefer to look at the code first? Read the docs.
Pull the ratings and top complaints for this Walmart air fryer
walmart.reviews({ urls: ["walmart.com/ip/..."],
max_reviews: 500, sort_by: "most-recent" })- Ninja 4-Qt Air Fryer — $79.00 (was $99.00)4.6 stars · 8,204 reviews · In Stock-20%
- 512 reviews paged, 71% verified purchasesorted most-recent · 132 with photosreviews
- Top complaint: "basket coating flaking after 3 months"surfaced across 24 recent 1-2 star reviewstheme
1 product · 512 reviews · surfaced in 6.4s
What you can extract from Walmart
Give the scraper Walmart product, search, category, or browse URLs, or plain search terms. The scrape verb returns product cards and full detail with a free on-page review sample; the reviews verb pages the complete public review history for any product. Walmart data is US marketplace (walmart.com), server-rendered as JSON for stability.
Product core
Name, item id (usItemId), brand, price, list price, availability, in-stock flag, and canonical URL for every product.
Ratings & review sample
Average stars and total review count on every product, plus a free sample of on-page reviews when you fetch full detail.
Deep reviews
The reviews verb pages the full public review history: rating, title, text, author, date, verified-purchase flag, helpful votes, images, and seller responses.
Sellers
The seller behind each product, typed as Walmart first-party (1P) or third-party marketplace (3P), with id and name.
Variants & media
Product variants (color, size, count) with their own item ids and prices, plus the gallery and thumbnail images.
Content & taxonomy
Short and long descriptions, specifications, category, and breadcrumb trail for catalog enrichment and classification.
What teams do with the Walmart API
Review mining and product research
Page the full review history for a product and brief an agent to cluster complaints, track sentiment over time, and separate verified-purchase signal from noise. Walmart exposes far more review depth than most marketplaces — use it to inform your roadmap or listing copy.
Price and buy-box tracking
Watch your own and competitors' prices, list prices, and which seller wins the offer (Walmart 1P vs a third-party marketplace seller). Run the same URLs on a schedule and diff the results to alert on undercuts and stockouts.
Seller and marketplace intelligence
See which third-party sellers are winning offers on the products that matter to you, and how first-party Walmart pricing compares, to size the marketplace opportunity in your category.
Catalog and assortment enrichment
Enrich a catalog by item id with structured attributes, variants, specifications, and images, and discover products from search or category URLs to map an entire assortment.
Call it from your code or your agent
One typed endpoint, one API key. Or add the SurfSense MCP server and let your agent call walmart.scrape as a native tool.
curl -X POST "$SURFSENSE_API_URL/workspaces/$WORKSPACE_ID/scrapers/walmart/scrape" \
-H "Authorization: Bearer $SURFSENSE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"search_terms": [
"air fryer"
],
"max_items": 5,
"include_reviews_sample": true
}'Walmart API request and response schema
The exact contract behind POST /workspaces/{workspace_id}/scrapers/walmart/scrape. The same fields power the walmart.scrape MCP tool.
Request parameters
walmart.scrape: provide urls or search_terms (at least one), up to 20 combined sources per call. For the full review history, use the walmart.reviews verb with product urls or item_ids.
| Field | Type | Description |
|---|---|---|
urls | string[] | Walmart product (/ip/), search (/search), category (/cp/), or browse (/browse/) URLs. Provide urls or search_terms. |
search_terms | string[] | Search phrases run on walmart.com, e.g. 'air fryer'. Provide search_terms or urls. |
max_items | integerdefault 10 | Max products per search term or category/browse URL, 1 to 100. |
include_details | booleandefault true | Fetch full product detail pages; false returns faster card-only results. |
include_reviews_sample | booleandefault true | Attach the free on-page review sample from each detail page. For full history use walmart.reviews. |
Response fields
The response is { items: [...] } with one item per product. One returned product is one billable unit; error items are never billed.
| Field | Type | Description |
|---|---|---|
name / usItemId / brand | string | Product identity: display name, Walmart item id, and brand. |
price / listPrice | object | Current price and strike-through list price, each with value and currency. |
stars / reviewsCount | number | Average star rating and total public review count. |
seller | object | Offer seller with id, name, and type (WALMART 1P or MARKETPLACE 3P). |
availabilityStatus / inStock | string | Availability label and a boolean in-stock flag. |
variants | object[] | Product variants (color, size, count) with their own item ids and prices. |
reviewsSample | object | Free sample of on-page reviews returned with full detail pages. |
A Walmart scraper API built for agents
Most Walmart data APIs bill per request, split product and review data across endpoints, and leave the discovery-to-detail logic to you. Here is how SurfSense compares.
| Feature | Typical Walmart data API | SurfSense |
|---|---|---|
| Pricing | Per-request pricing that climbs fast at scale | Pay per product or per review returned, with a free tier to start |
| Discovery | Separate search and detail endpoints you stitch together | One verb takes search terms or product, search, category, and browse URLs |
| Reviews | A separate paid endpoint, often capped shallow | A dedicated verb pages the full public review history with photos and seller replies |
| Data access | Requires accounts, keys, or approval for many providers | Public, anonymous data only — no login or seller account |
| Agent-ready | No; you wire the harness yourself | MCP server exposes walmart.scrape and walmart.reviews as native tools |
Walmart Product & Review API: frequently asked questions
What is the Walmart product API?
It returns a Walmart listing's data as structured JSON instead of raw HTML. The SurfSense Walmart API scrapes public product pages and gives you price, rating, seller, variants, availability, and specifications as clean JSON your agents can read.
Does Walmart have an API?
Walmart's official APIs — Marketplace and Walmart Connect — are for approved sellers and advertisers, and neither exposes public product or review data at scale. The SurfSense Walmart API is an independent alternative: one key, no seller account, and structured public product and review JSON back.
Can I track Walmart prices with it?
Yes. Each product returns its current price, list price, availability, and the seller behind the offer. Run the same URLs or search terms on a schedule and diff the results to build Walmart price tracking and buy-box alerts without maintaining scrapers or proxies yourself.
Can I get the full Walmart review history?
Yes. The walmart.reviews verb pages the complete public review history for a product — rating, title, text, author, date, verified-purchase flag, helpful votes, images, and seller responses. Pass product URLs or item ids and set max_reviews and sort_by.
Does it only use public data?
It does. The scraper collects public, anonymous Walmart data only — no login or seller account. That covers product details, prices, ratings, public reviews, seller identity, variants, and availability.
How do I look up a product by item id or search term?
Pass a product URL (which contains the item id) or a phrase in search_terms to discover products. You can also pass search, category, and browse URLs. walmart.scrape handles discovery; walmart.reviews takes urls or item_ids directly.
Which Walmart marketplace is supported?
The scraper targets the US marketplace at walmart.com. Data is read from the server-rendered JSON Walmart ships in the page, which keeps extraction stable against the frequent front-end A/B testing on the site.
Point your agents at Walmart
The Walmart connector is one of many in the SurfSense open web research platform. Start free, no credit card required.