retailerapi / docs

GET /v1/sellers/{id}

Walmart Marketplace seller profile.

Request

GET /v1/sellers/{seller_id}

Seller IDs are 32-character alphanumeric strings (e.g. F55CDC31AB754BB68FE0B39041159D63) returned in the offers array of the products endpoint.

Response

{
  "seller_id": "EA287F75E1B648DF835939C495845D53",
  "seller_name": "MW Recyclers Inc",
  "rating": 4.5,
  "rating_count": 124,
  "active_listings": 18,
  "account_age_days": null,
  "status": "ACTIVE",
  "seller_type": "EXTERNAL",
  "pro_seller": false,
  "profile_url": "https://www.walmart.com/global/seller/101027792/cp/shopall",
  "categories": null,
  "location": {
    "city": "Orland Park",
    "state": "IL",
    "postal_code": "60462",
    "country": "US"
  },
  "tokens_consumed": 2,
  "tokens_remaining": 9998
}

Field notes

  • status values: ACTIVE, ONBOARDING_INACTIVE, INACTIVE, SUSPENDED. Check this before trusting rating / listing counts on a seller you haven't seen recently.
  • seller_type: FIRST_PARTY (Walmart direct) or EXTERNAL (third-party marketplace).
  • pro_seller: boolean — true for sellers who meet Walmart's Pro Seller performance bar.
  • account_age_days and categories are null on most sellers — upstream doesn't expose them yet.
  • Looking up a first-party Walmart seller id (e.g. F55CDC31AB754BB68FE0B39041159D63) returns a typed 404 — first-party doesn't have a marketplace profile.

Cost

2 tokens per call.

Notes

  • Walmart Marketplace sellers only today. Amazon seller profiles ship Phase 3.
  • Use the bulk-search endpoint (Phase 2) when you need to look up many sellers at once.