nvNeuralVerge
E-commerce & Marketplaces

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.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Checking the storefront by handOpen the seller page and read itFree, and slowFine for one seller, useless across a supply chain
Building a scraperWrite it, host it, and repair it when Walmart changes the storefront pageEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request per seller$5 per 1,000, misses not billedNeeds the right ID — the product-page hash won't resolve
Response

What you get back

Every field in the example response below.

FieldTypeDescription
idstringWalmart catalogSellerId.
urlstringStorefront URL.
namestringStorefront display name.
legal_namestringSeller's registered legal name, when published.
typestringINTERNAL for Walmart.com itself, EXTERNAL for a marketplace seller.
is_pro_sellerbooleanWhether Walmart designates this a Pro Seller.
ratingnumberAverage seller rating.
review_countnumberNumber of seller reviews.
text_review_countnumberNumber of reviews that include written text.
imagestringSeller logo image URL.
bannernullStorefront banner image URL, when the seller has one. Null in the example.
locationstringSeller location as published.
addressstringStreet address, when published.
citystringCity.
statestringState or province.
countrystringCountry code.
postal_codestringPostal code.
emailstringContact email, when published.
phonestringContact phone number, when published.
statusstringAccount status, e.g. ACTIVE.
is_activebooleanWhether the seller account is active.
is_alcohol_sellerbooleanWhether the seller is registered to sell alcohol.
is_qsr_sellerbooleanWhether the seller is registered as a quick-service restaurant.
Response

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
}
Integration

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" }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Supplier vetting

Check a third-party seller's rating and location before sourcing from their storefront.

Chained lookups from a product

Resolve the seller behind a listing you already pulled with Walmart product.

Competitive mapping

Identify who else sells in a category and how they're rated.

Contact discovery

Pull whatever contact information a storefront publishes.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Walmart marketplace sellers with a public storefront.

Freshness

Read at request time.

Handling

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.

What it will not do
  • —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.
FAQ

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

Related sources

Try walmart seller on your own data

One request format across every source in the catalog.

Get started