Walmart Seller Data API and MCP — Rating, Location & Contact
Send a Walmart storefront ID or URL and this source returns the seller's profile as data: rating, location and the contact information the storefront publishes.
- You send
- A Walmart catalogSellerId or storefront URL
- You get back
- Seller rating, location and contact information
- Coverage
- Walmart marketplace sellers with a public storefront.
- Price
- 5 pts — $5 per 1,000
- Charged only when the seller resolves. A storefront that cannot be found 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 storefront by hand | Open the seller page and read it | Free, and slow | Fine for one seller, useless across a supply chain |
| Building a scraper | Write it, host it, and repair it when Walmart changes the storefront page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per seller | $5 per 1,000, misses not billed | Needs the right ID — the product-page hash won't resolve |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
id | string | Walmart catalogSellerId. |
url | string | Storefront URL. |
name | string | Storefront display name. |
legal_name | string | Seller's registered legal name, when published. |
type | string | INTERNAL for Walmart.com itself, EXTERNAL for a marketplace seller. |
is_pro_seller | boolean | Whether Walmart designates this a Pro Seller. |
rating | number | Average seller rating. |
review_count | number | Number of seller reviews. |
text_review_count | number | Number of reviews that include written text. |
image | string | Seller logo image URL. |
banner | null | Storefront banner image URL, when the seller has one. Null in the example. |
location | string | Seller location as published. |
address | string | Street address, when published. |
city | string | City. |
state | string | State or province. |
country | string | Country code. |
postal_code | string | Postal code. |
email | string | Contact email, when published. |
phone | string | Contact phone number, when published. |
status | string | Account status, e.g. ACTIVE. |
is_active | boolean | Whether the seller account is active. |
is_alcohol_seller | boolean | Whether the seller is registered to sell alcohol. |
is_qsr_seller | boolean | Whether the seller is registered as a quick-service restaurant. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "walmart_seller",
"seller": "https://www.walmart.com/global/seller/102730552",
"human": "# Walmart seller\n\n- **Seller:** https://www.walmart.com/global/seller/102730552\n- **Response size:** 482.5 KB\n- **Name:** LoopTone\n- **Rating:** 4.424050632911392 (163 reviews)\n- **Location:** Huizhou, GD, CN\n- **Status:** ACTIVE",
"machine": {
"seller": {
"id": "102730552",
"url": "https://www.walmart.com/seller/102730552",
"name": "LoopTone",
"legal_name": "huizhoushideshengyuandianziyouxiangongsi",
"type": "EXTERNAL",
"is_pro_seller": false,
"rating": 4.424050632911392,
"review_count": 163,
"text_review_count": 26,
"image": "https://i5.walmartimages.com/asr/46c8ddb7-a33e-4cc2-a9fd-4a81df9a5f3f.8742a7a126069628a7a767ec11ea6cc3.jpeg",
"banner": null,
"location": "Huizhou, GD, CN",
"address": "No.10 Qingtang North Road Xiaojinkou",
"city": "Huizhou",
"state": "GD",
"country": "CN",
"postal_code": "516023",
"email": "looptone@desonic.cn.com",
"phone": "13059566770",
"status": "ACTIVE",
"is_active": true,
"is_alcohol_seller": false,
"is_qsr_seller": false
},
"response_bytes": 494109
},
"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.
seller must be the numeric catalogSellerId or a storefront URL — not the 32-character hash Walmart shows on product pages. Get the working value from seller.storefront_url in a Walmart product response.
curl -X POST https://api.neuralverge.ai/functions/v1/run-walmart-seller \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "seller": "102730552" }'What teams use it for
Where this field shows up in an actual workflow.
Check a third-party seller's rating and location before sourcing from their storefront.
Resolve the seller behind a listing you already pulled with Walmart product.
Identify who else sells in a category and how they're rated.
Pull whatever contact information a storefront publishes.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Walmart marketplace sellers with a public storefront.
Read at request time.
This source returns publicly visible seller information, stamped with the seller ID or URL it was read from and a session id you can trace.
- —Contact information is only as complete as what the seller chooses to publish.
- —Rating and review counts reflect Walmart's own aggregation, not an independent audit.
- —A seller ID from anywhere other than a Walmart product response's storefront_url may not resolve.
Questions, answered
Product pages show a 32-character seller hash, and this endpoint doesn't accept it. It needs the numeric catalogSellerId or a full storefront URL — run Walmart product on that same item first and take the value from seller.storefront_url.
Related sources
Try walmart seller on your own data
One request format across every source in the catalog.