seller
Amazon SELLER profile by seller id, optionally with the products the seller sells. USE WHEN the user asks about a third-party seller / merchant / storefront (who they are, how they are rated, what they sell) - the seller id is the 'A...' code in /sp?seller=... or the seller_id on any offer the product tool returns. RETURNS seller (name, rating, lifetime and 12-month rating counts, positive %, is_amazon), feedback_summary per period (30 d / 90 d / 12 m / lifetime: average rating + count - Amazon no longer publishes positive/neutral/negative splits), rating_histogram, recent_feedback (up to 5 entries as date / rating / struck ONLY - never the buyer's name or text), and business (legal name, registration / VAT numbers, address, phone, email, representative) where the seller publishes it on Amazon - all 11 marketplaces; au and ca pages carry no business block, so it is null there. With products=true, also seller_products: mode=live the storefront as Amazon shows it now (the serp object, SECONDS), mode=cache the products we OBSERVED the seller offering (25 per page, buy-box days, observed price range, <100 ms). MODES for the profile: cache = our stored observation - the seller page as our tracker last read it (the full profile; sellers are re-read about every 14 days), or the page fetched in the last 24 h, or for sellers not stored yet the warehouse rating record; live = fetch the seller page now (5-20 s, up to ~30 s); auto (default) = stored when younger than max_age_days (default 14), else live. tracking{} says since when we have observed the seller (observed_first_seen), when last (last_observed) and how often - OBSERVED, never 'founded' or 'active since'. With history=true also history{}: the seller's rating change points (positive %, star rating, counts per 30 d / 90 d / 12 m / lifetime) and storefront-size points, oldest first, UTC - change points, each value holds until the next; the series starts 2026-10-04 at the earliest, so expect 1-2 points per seller for now. HONESTY: a 404 means Amazon has no seller page for that id on that marketplace (or we never observed it, in cache mode); a 502 is a collection failure, not a fact about the seller - retry. An empty storefront does not confirm the seller exists. LOOKUP: give seller_id, or name (resolved through observed buy-box data to the id, free). COST: paid plan required - the tool is listed only for keys on a paid plan (no free lane). Profile: 1 credit live, 0.5 from cache, auto bills what was served; history=true +0.5 once when at least one point comes back. Products: 1 credit per storefront page fetched (live) or per page of 25 observed products (cache). Feedback, business details and tracking are included at no extra charge. Not found, unavailable, blocked, empty storefront, empty history: 0. DERIVED (2026-10-05): brands=true adds the operator footprint - the brands this seller was observed winning the buy box on, with buy-box days (+1 credit per page of 25); network=true adds the connected sellers that win on the same brands (+1 credit).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Profile lane (see description). products=true uses products_mode. | auto |
| name | No | Instead of seller_id: the seller's display name as Amazon prints it (e.g. 'Total Office Solutions'). Resolved through observed buy-box data to the seller id; a name we have never observed, or one with no id on record, returns guidance - nothing is billed. | |
| page | No | Products page (cache: 25 per page; live: Amazon's page 1-10). | |
| brands | No | Also return the operator footprint: brands this seller was observed winning the buy box on (16 months), 25 per page (brands_page). +1 credit per page. | |
| country | No | Amazon marketplace. No Walmart - seller pages are Amazon-only. | us |
| history | No | Also return history{} (rating + storefront-size change points, oldest first, UTC). +0.5 credit when non-empty. | |
| network | No | Also return connected sellers: sellers winning the buy box on the same brands, strongest overlap first (max 50). +1 credit. | |
| max_page | No | live products only: auto-paginate up to this page (max 10); billed per page fetched. | |
| products | No | Also return the seller's products (billed separately, see description). | |
| seller_id | No | Amazon seller id: 'A' + 8-24 letters/digits. | |
| brands_page | No | ||
| max_age_days | No | auto only: how old the stored observation may be before fetching live (default 14 = the tracker's cadence). | |
| products_mode | No | cache = observed products (fast); live = the storefront now (seconds). | cache |
| history_points | No | history=true: the latest N change points per series (1-5000). |