watchlist_stats
Retrieve a bulk report of Amazon stats for your entire sourcing watchlist in one call. Get composite scores, seller counts, buy-box shares, and fulfillment data for every tracked ASIN.
Instructions
BULK report of key Amazon stats for the user's WHOLE watchlist in ONE call — every tracked ASIN in the workspace's sourcing watchlist for a marketplace, in a single pass. Use this report instead of looping a per-ASIN tool over the whole watchlist. Each tracked ASIN returns its composite sourcing score, distinct seller count, buy-box leader share, fulfillment (FBA/FBM/AMZ with amz/fba pct), product brand/title and price (or price range). Also returns a top-level summary across the whole watchlist (tracked total, scored count, average score, score buckets, Amazon-dominant / FBA-dominant counts, single-seller vs high-competition counts). Use when the user asks 'show stats for my whole watchlist', 'summarize my watchlist', 'which of my tracked ASINs are single-seller / Amazon-dominant / high-competition', 'score distribution of my watchlist', or any bulk watchlist overview. One call covers the entire watchlist — do NOT call a per-ASIN tool in a loop.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| marketplace_id | No | Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US. One marketplace per call. | |
| sort | No | Sort order (all descending): score (composite sourcing score, default), seller_count (distinct sellers), buybox_share (buy-box leader share), amz_dominance, fba_penetration, or price. | |
| limit | No | ||
| min_composite_score | No | Only tracked ASINs with composite sourcing score >= this. | |
| max_composite_score | No | ||
| min_seller_count | No | Only ASINs with >= this many distinct sellers. | |
| max_seller_count | No | ||
| min_buybox_share_pct | No | Only ASINs where the buy-box leader's share >= this percent. | |
| max_buybox_share_pct | No | ||
| min_amz_dominance_pct | No | Only ASINs with Amazon buy-box dominance >= this percent. | |
| max_amz_dominance_pct | No | ||
| min_fba_penetration_pct | No | Only ASINs with FBA penetration >= this percent. | |
| max_fba_penetration_pct | No | ||
| min_price | No | ||
| max_price | No | ||
| fulfillment_in | No | Comma-separated FBA/FBM/AMZ to keep. | |
| product_brand | No | Exact product brand (case-insensitive). | |
| product_brand_contains | No | ||
| asin | No | Exact ASIN match. | |
| asin_contains | No |