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.
$
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
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.
SurfSenseSurfSense