Walmart Product Data API and MCP — Price, Rating & Seller Info
Send a Walmart item ID or product URL and this source returns the listing as structured data: brand, price, rating, specifications, and the seller behind the listing.
- You send
- A Walmart item ID or product URL
- You get back
- Brand, price, rating, specifications and seller (including the storefront ID for a seller lookup)
- Coverage
- Walmart.com listings with a public product page.
- Price
- 5 pts — $5 per 1,000
- Charged only when the item resolves. An item ID or URL that doesn't resolve is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Checking the listing by hand | Open the page and read it | Free, and slow | Fine for one item, useless across a catalog |
| Building a scraper | Write it, host it, and repair it when Walmart changes the page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per item | $5 per 1,000, misses not billed | Returns what the listing publishes at request time — prices and stock move |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
id | string | Walmart item ID (same value as us_item_id). |
us_item_id | string | Walmart item ID. |
walmart_internal_id | string | Walmart's internal identifier for the listing. |
name | string | Product title. |
brand | string | Product brand as listed. |
brand_url | string | Relative link to the brand's page on Walmart.com. |
model | string | Model number, when the listing publishes one; null otherwise. |
upc | string | UPC code. |
manufacturer_product_id | string | Manufacturer's own product ID, when published; null otherwise. |
price | number | Current price. |
price_string | string | Current price formatted with a currency symbol. |
currency | string | ISO currency code. |
list_price | number | Pre-discount list price, when the item is on sale; null otherwise. |
rating | number | Average star rating. |
review_count | number | Number of reviews. |
image | string | Primary product image URL. |
images | array | All product image URLs. |
availability_status | string | Stock status, e.g. IN_STOCK. |
is_in_stock | boolean | Whether the item is currently in stock. |
short_description | string | Marketing description text. |
seller | object | Seller id, name, display_name, storefront_url and type (INTERNAL or EXTERNAL). In the example the seller is a third-party seller and storefront_url is a full storefront link — the value a Walmart seller lookup needs, not the hash in seller.id. It's null for items sold by Walmart itself (type INTERNAL), which have no storefront. |
breadcrumbs | array | Category breadcrumb trail. |
category | string | Leaf category name. |
return_policy | object | Return window, eligibility and policy text. |
variants | array | Other variant SKUs of this product, when present. |
badges | array | Promotional badges shown on the listing, when present. |
condition | string | Item condition, e.g. "New". |
is_preowned | boolean | Whether the listing is for a pre-owned item. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "walmart_product",
"item": "15290971475",
"human": "# Walmart product\n\n- **Item:** 15290971475\n- **Response size:** 508.2 KB\n- **Name:** LoopTone Vinyl Record Player Turntable with Bluetooth, CD, Tape, Radio, USB Recorder, Stereo Home System\n- **Price:** USD129.99\n- **Rating:** 4.3 (644 reviews)\n- **Availability:** IN_STOCK",
"machine": {
"product": {
"id": "15290971475",
"us_item_id": "15290971475",
"walmart_internal_id": "0W0FAWCUKZIK",
"name": "LoopTone Vinyl Record Player Turntable with Bluetooth, CD, Tape, Radio, USB Recorder, Stereo Home System",
"brand": "LoopTone",
"brand_url": "/search?q=LoopTone&facet=brand:LoopTone",
"model": "18CDBB-B",
"upc": "797457436581",
"manufacturer_product_id": "18CDBB-B",
"price": 129.99,
"price_string": "$129.99",
"currency": "USD",
"list_price": 199.99,
"rating": 4.3,
"review_count": 644,
"image": "https://i5.walmartimages.com/seo/LoopTone-3-Speed-Vinyl-Record-Player-Bluetooth-In-Out-Belt-Drive-10-1-Vintage-Turntable-CD-Cassette-Player-AM-FM-Radio-USB-Recorder-Aux-RCA_c1b0de94-723d-4497-855b-26d",
"images": [
"https://i5.walmartimages.com/seo/LoopTone-3-Speed-Vinyl-Record-Player-Bluetooth-In-Out-Belt-Drive-10-1-Vintage-Turntable-CD-Cassette-Player-AM-FM-Radio-USB-Recorder-Aux-RCA_c1b0de94-723d-4497-855b-26d",
"https://i5.walmartimages.com/asr/da958ea6-a038-4776-8183-83369a0d1cea.3de9c5f2baa034120f67daf54a989cc4.jpeg"
],
"availability_status": "IN_STOCK",
"is_in_stock": true,
"short_description": "<p>This LoopTone Audio Turntable offers a vintage-themed entertainment experience with modern features. Play your vinyl records at 33 1/3 rpm using the belt drive system. Connect your smartphone or ot",
"seller": {
"id": "47D6101AABDC40719510F4D0079EEF41",
"name": "huizhoushideshengyuandianziyouxiangongsi",
"display_name": "LoopTone",
"storefront_url": "https://www.walmart.com/global/seller/102730552",
"type": "EXTERNAL"
},
"breadcrumbs": [
"Musical Instruments",
"DJ Turntables, Controllers, Mixers, and other DJ Equipment"
],
"category": "Turntables and Record Players",
"return_policy": {
"returnable": true,
"freeReturns": true,
"returnWindow": {
"value": 30,
"unitType": "Day"
},
"returnPolicyText": "Free Holiday returns until Jan 31",
"returnPolicyTextCode": {
"code": "PRODUCT_HOLIDAY_RETURN",
"data": null
},
"returnPolicyCondition": null,
"holidayReturnEnabled": true,
"returnPolicyClarityText": "",
"returnPolicyClarityTextMore": "",
"returnPolicyType": null,
"returnableToStore": true,
"returnLocation": null
},
"variants": [],
"badges": [],
"condition": "New",
"is_preowned": false
},
"response_bytes": 520381
},
"total_points": 5
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
One item per request. Save seller.storefront_url from the response if you plan to run a Walmart seller lookup next — it's the only reliable source for the ID that endpoint needs.
curl -X POST https://api.neuralverge.ai/functions/v1/run-walmart-product \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "item": "15290971475" }'What teams use it for
Where this field shows up in an actual workflow.
Track how a listing's price and stock level move over time.
Compare specifications and ratings across similar listings.
Pull seller.storefront_url here before running Walmart seller — it's the working ID, not the hash on the page.
Build a picture of how a category is priced and rated on Walmart.com.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Walmart.com listings with a public product page.
Read at request time.
This source returns publicly visible product information, stamped with the item ID or URL it was read from and a session id you can trace.
- —Price and stock reflect the moment of the request and can change immediately after.
- —Specifications are only as complete as what the listing publishes.
- —Third-party marketplace listings vary in how much seller detail they include.
Questions, answered
Because the seller ID shown on a Walmart product page is a 32-character hash the seller endpoint doesn't accept. The numeric catalogSellerId or storefront URL it needs is in this response's seller.storefront_url, not anywhere on the page you'd copy from.
Related sources
Find items by keyword before you look one up.
Look up the seller using the storefront_url this response returns.
The same idea on another marketplace.
Amazon, eBay, Walmart, AliExpress and Alibaba product, seller and review data.
Try walmart product on your own data
One request format across every source in the catalog.