Amazon brand, seller, niche & buy-box intelligence inside your own Claude or ChatGPT.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Find Alibaba supplier / manufacturer listings for a query (via Serper site:alibaba.com) — returns title + rating + a supplier snippet + the Alibaba link. TEXT ONLY: no price or photo are available via this source (the user sees price / MOQ / photos on Alibaba after clicking).
The product / OEM query (brand-free for private label).
Find Alibaba supplier / manufacturer listings for a query (via Serper site:alibaba.com) — returns title + rating + a supplier snippet + the Alibaba link. TEXT ONLY: no price or photo are available via this source (the user sees price / MOQ / photos on Alibaba after clicking).
| Argument | Type | Description |
|---|---|---|
| query* | string | The product / OEM query (brand-free for private label). |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The product / OEM query (brand-free for private label)."
}
}
}Fetch a LIVE Amazon search-results page (SERP) right now — the ranked organic + sponsored listings a shopper would see this minute for a query, with position, ASIN, title, price, rating and badges. Use when the user wants CURRENT ranking/visibility: 'who ranks for "dog bed" on Amazon right now', 'is my ASIN on page 1 for this keyword', 'what's sponsored vs organic for this search'. This is a real-time fetch (takes ~10-40 seconds) — for warehouse keyword search use search_products; for buying advice use shopping_search. Amazon marketplaces only; up to 3 pages per call.
| Argument | Type | Description |
|---|---|---|
| page | integer | Start page (default 1). |
| sort_by | string | Amazon sort order (default: featured). |
| max_page | integer | Auto-paginate through this page (max 3 per call). |
| search_term* | string | The query exactly as a shopper would type it. |
| marketplace_id | integer | 1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR (Amazon only; no Walmart). |
| exclude_sponsored | boolean | Drop sponsored placements from the results. |
{
"type": "object",
"required": [
"search_term"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"description": "Start page (default 1)."
},
"sort_by": {
"enum": [
"featured",
"price_low_to_high",
"price_high_to_low",
"avg_customer_review",
"most_recent",
"best_seller"
],
"type": "string",
"description": "Amazon sort order (default: featured)."
},
"max_page": {
"type": "integer",
"description": "Auto-paginate through this page (max 3 per call)."
},
"search_term": {
"type": "string",
"description": "The query exactly as a shopper would type it."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR (Amazon only; no Walmart)."
},
"exclude_sponsored": {
"type": "boolean",
"description": "Drop sponsored placements from the results."
}
}
}Best Sellers Rank (BSR) HISTORY for one Amazon ASIN — the observed rank series over time, with first/last observation dates, plus the product's identity (brand, title, price, rating, current BSR). Use when the user asks how an ASIN's rank/demand has MOVED: 'BSR history for B0…', 'is this product's rank improving', 'rank trend over the last months'. For WHO sells it over time use asin_buybox_history instead; for a live snapshot right now use collect_asin_now. Amazon marketplaces only; one ASIN per call.
| Argument | Type | Description |
|---|---|---|
| asin* | string | The 10-character Amazon ASIN. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "The 10-character Amazon ASIN."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Show which sellers have been winning the buybox for an ASIN over time, AND how the competing-seller pool has changed month over month. Returns a per-week breakdown of buybox winners; a monthly distinct-seller-count series (seller_count_monthly, trailing ~6 months) plus a seller_trend label (stable/rising/falling) so you can say whether the seller pool is stable or volatile (more sellers piling on vs consolidating); plus the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user asks 'who has been winning buybox on this ASIN', 'buybox history for B08N5WRWNW', 'seller rotation', 'has the buybox owner changed', 'is the seller pool stable or volatile', 'are more sellers piling onto this listing', or any ASIN buybox/seller timeline.
| Argument | Type | Description |
|---|---|---|
| asin* | string | ASIN to look up (e.g. B08N5WRWNW). |
| max_price | number | |
| min_price | number | |
| seller_name | string | Exact buy-box seller name (case-insensitive). |
| since_weeks | integer | Weeks of history (default 26, max 52). |
| last_seen_to | string | |
| first_seen_to | string |
Find ASINs similar to a given ASIN by brand, price band, and seller count. Use when the user asks 'ASINs like this one', 'similar products', 'comparable ASINs', 'what else is like B08N5WRWNW', or any ASIN-level lookalike question. Each comparable carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).
| Argument | Type | Description |
|---|---|---|
| asin* | string | Reference ASIN (e.g. B08N5WRWNW). |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| buybox_seller | string | Exact buy-box seller name (case-insensitive). |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Reverse ASIN on Amazon US: the observed head search terms where a product appeared on page 1 (organic rank, or a sponsored unit in the page), dated, organic first. Pass asins (up to 10, yours first) to compare with competitors: each keyword shows every competitor's rank, asins_on_page, and gap=true where a competitor is on page 1 and the first product is not; gaps_only=true keeps only those. Coverage is head search terms and page 1 only (the coverage block gives the counts), so a product shows fewer keywords than a full search index would. Not volume figures. Amazon US only.
| Argument | Type | Description |
|---|---|---|
| asin | string | One ASIN. Use asins to compare. |
| asins | array | Up to 10 ASINs, the product first, then its competitors. |
| limit | integer | Keywords per answer (1-100). |
| offset | integer | |
| gaps_only | boolean | With asins: only keywords where a competitor is on page 1 and the first product is not. |
| placement | string |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "One ASIN. Use asins to compare."
},
"asins": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "Up to 10 ASINs, the product first, then its competitors."
},
"limit": {
"type": "integer",
"default": 50,
"description": "Keywords per answer (1-100)."
},
"offset": {
"type": "integer",
"default": 0
},
"gaps_only": {
"type": "boolean",
"default": false,
"description": "With asins: only keywords where a competitor is on page 1 and the first product is not."
},
"placement": {
"enum": [
"all",
"organic",
"sponsored"
],
"type": "string",
"default": "all"
}
}
}Estimate whether an ASIN can hit a target profit margin given current buybox price, estimated FBA fees, and Amazon referral fee. Use when the user asks 'can I make money on this ASIN', 'profit calculator', 'margin estimate for B08N5WRWNW', 'is this ASIN profitable to sell', or any margin/profit question. Also returns product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct) for the ASIN.
| Argument | Type | Description |
|---|---|---|
| asin* | string | ASIN to analyze (e.g. B08N5WRWNW). |
| cogs | number | Your cost of goods in USD. If omitted, the tool estimates breakeven COGS. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| target_margin_pct | number | Target profit margin percentage (default 20). |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "ASIN to analyze (e.g. B08N5WRWNW)."
},
"cogs": {
"type": "number",
"description": "Your cost of goods in USD. If omitted, the tool estimates breakeven COGS."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"target_margin_pct": {
"type": "number",
"description": "Target profit margin percentage (default 20)."
}
}
}List the saved authorized sellers for a brand. Use when the user asks 'who are my authorized sellers for X', 'show my approved resellers', 'what's my whitelist for this brand'.
| Argument | Type | Description |
|---|---|---|
| brand* | string | The brand. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| seller_contains | string | Only return saved seller names containing this substring (case-insensitive). |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "The brand."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"seller_contains": {
"type": "string",
"description": "Only return saved seller names containing this substring (case-insensitive)."
}
}
}Save the authorized sellers for a brand you own/manage — the whitelist that makes 'unauthorized seller' detection possible. The brand must already be tracked in this workspace. Use when the user says 'these are my authorized sellers for X', 'add Y to my authorized list', 'set my brand's approved resellers'. Pass the seller names exactly as they appear on Amazon.
| Argument | Type | Description |
|---|---|---|
| brand* | string | The brand (must be a tracked workspace brand). |
| sellers* | array | Authorized seller names to save. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [
"brand",
"sellers"
],
"properties": {
"brand": {
"type": "string",
"description": "The brand (must be a tracked workspace brand)."
},
"sellers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Authorized seller names to save."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Show how a brand's buybox concentration has changed over time. Returns weekly seller counts and observed buybox days for the trailing window. Use when the user asks 'is this brand getting more competitive', 'concentration trend for Nike', 'how has seller count changed over time', or 'buybox trajectory'.
| Argument | Type | Description |
|---|---|---|
| brand* | string | Brand name (case-insensitive). |
| trend_in | string | Comma-separated trend labels to keep: CONCENTRATING, DECONCENTRATING, STABLE, INSUFFICIENT_DATA. If the brand's trend isn't in the list, an empty result is returned. |
| since_weeks | integer | Weeks of history to return (default 26, max 52). |
| week_start_to | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| week_start_from | string | Keep only timeline weeks on/after this YYYY-MM-DD. |
| max_observations | number | |
Show ASINs that recently appeared for a brand. Use when the user asks 'new products for Nike', 'recently added ASINs', 'what new listings does this brand have', or any question about a brand's recent catalog additions. Each ASIN carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| brand* | string | Brand name (case-insensitive). |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| since_days | integer | How far back to look (default 30, max 180). |
| last_seen_to | string | |
| asin_contains | string | |
| first_seen_to | string | |
| product_brand |
Find brands similar to a given brand by category, price tier, and competition level. Use when the user asks 'brands like Nike', 'similar brands to source', 'show me comparable brands', 'what else is in this niche', or any cohort/lookalike question.
| Argument | Type | Description |
|---|---|---|
| brand* | string | Reference brand name (case-insensitive). |
| limit | integer | |
| max_avg_price | number | |
| min_avg_price | number | |
| brand_contains | string | Only keep similar brands whose name contains this substring. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number | |
| min_asin_count | number | |
| max_seller_count |
Detect whether a brand is under competitive attack: an elevated NEW-ENTRANT RATE (brand-level newly-observed sellers vs the trailing-month baseline) combined with buy-box churn. Uses brand-level first-seen (a seller's first observation anywhere across the brand's ASINs), which is stable under scraper-coverage growth — not the inflated per-ASIN count. Use when the user asks 'is my brand being targeted', 'brand under attack', 'new sellers flooding my listings', 'is someone targeting this brand'.
| Argument | Type | Description |
|---|---|---|
| brand* | string | Brand name (case-insensitive). |
| signals_in | string | Comma-separated signals that must be present: NEW_ENTRANT_SURGE, HIGH_BUYBOX_CHURN. Matches if the brand has any of them. |
| since_weeks | integer | Window to analyze (default 4, max 12). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| threat_level_in | string | Comma-separated threat levels to keep: HIGH, MODERATE, LOW. If the brand's level isn't in the list, an empty result is returned. |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"signals_in": {
"type": "string",
"description": "Comma-separated signals that must be present: NEW_ENTRANT_SURGE, HIGH_BUYBOX_CHURN. Matches if the brand has any of them."
},
"since_weeks": {
"type": "integer",
"description": "Window to analyze (default 4, max 12)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"threat_level_in": {
"type": "string",
"description": "Comma-separated threat levels to keep: HIGH, MODERATE, LOW. If the brand's level isn't in the list, an empty result is returned."
}
}
}Check whether a brand sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace seller count, ASIN count, observed buybox days, and control score. Use when the user asks 'does this brand sell on Walmart', 'cross-marketplace presence for Nike', 'is this brand on Amazon UK', or any multi-marketplace brand question.
| Argument | Type | Description |
|---|---|---|
| brand* | string | Brand name (case-insensitive). |
| max_asin_count | number | |
| min_asin_count | number | |
| max_seller_count | number | |
| min_seller_count | number | |
| marketplace_id_in | string | Comma-separated marketplace ids to keep: 1=Amazon UK, 2=Amazon US, 3=Walmart US. |
| max_control_score | number | |
| min_control_score | number | |
| max_observed_buybox_days | number |
Find brands that recently gained the most newly-OBSERVED sellers (sellers whose first-seen date on the brand falls in the window) — an observation signal, NOT confirmed market entry (sparse re-sampling can resurface long-present sellers as 'new'). Optional category filter. Use when the user asks 'brands gaining sellers in [category]', 'brands under hijacker pressure', 'who is seeing new entrants this month', or category-scoped seller-growth signals without naming a specific brand.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| scope | string | tracked = only brands on the user's watchlist; universe = all brands. Default universe. |
| category | string | |
| window_days | integer | Days back (default 30, max 90). |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Find brands that share operators/sellers with a target brand. Returns brands ranked by how many operators they share. Use when the user asks 'what brands are in X's network?', 'brands related to Ninja', 'who else do Ninja's sellers carry?', 'brands in the same seller network', or 'brand family'. This reveals the operator graph — brands connected through shared distribution channels.
| Argument | Type | Description |
|---|---|---|
| brand* | string | The target brand to find network connections for. |
| limit | integer | |
| brand_contains | string | Only keep related brands whose name contains this substring. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_seller_count | number | |
| min_seller_count | number | |
| max_control_score | number | |
| min_control_score |
Match a LIST of ASINs and/or retail barcodes (UPC / EAN / GTIN / ISBN) to Amazon in one call - e.g. a supplier price list or invoice - and return one row per item: ASIN, title, brand, current price, buy-box seller and fulfillment, whether Amazon sells it, seller count, BSR and category, rating, bought-past-month badge, how the barcode was resolved, and when it was observed. Unknown barcodes are searched on Amazon itself. Use for wholesale / online-arbitrage list screening before deeper checks with asin_profit_calc, evaluate_asin_sourcing or live_offers. Up to 25-200 items per call depending on plan. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| items* | array | ASINs and/or barcodes (a comma-separated string is accepted too). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
},
"description": "ASINs and/or barcodes (a comma-separated string is accepted too)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Find the ASINs where a brand you own has LOST the buy box to a seller outside your authorized list — ranked by estimated revenue at stake — so you can act on the costliest first. Each flagged ASIN carries its product brand, title and price (or price range) plus its fulfillment (FBA/FBM/AMZ). Save your authorized list first (authorized_seller_set) for precise flagging; without it, ASINs where a third-party operator holds the buy box are flagged. Use when the user asks 'where am I losing the buy box on <brand>', 'buy-box loss on my ASINs', 'which of my listings did I lose'.
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| brand* | string | The brand you own/manage. |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| asin_contains | string | |
| buybox_holder | string | Exact current buy-box holder (case-insensitive). |
| product_brand | string | Exact product brand (case-insensitive). |
Find categories where Amazon is retreating — net brand exits exceed entries over 90 days (amazon_expansion_net_90d < 0). Returns categories ordered by retreat magnitude. Use when the user asks 'where is Amazon pulling back?', 'which categories is Amazon leaving?', or 'Amazon retreat opportunities'.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (capped at 10). Default 10. |
| category_name | string | Exact category name (case-insensitive). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| max_asin_count | number | |
| min_asin_count | number | |
| max_brand_count | number | |
| min_brand_count | number | |
| velocity_tier_in | string | Comma-separated velocity tiers to keep. |
Return the full metric set for ONE category at any depth — a root OR a sub-category niche like 'Terrariums'. Covers demand (30-day revenue, units, velocity tier), competition (heat, diversity, brand/ASIN/seller counts), Amazon presence (retail dominance, private-label share, FBA penetration, 90-day brand expansion), price, ship-by days, and close-outs. Use for 'show me the metrics/stats for category X', 'how big is the X category', or to pull the numbers behind a niche question.
| Argument | Type | Description |
|---|---|---|
| category_id | integer | Exact category id (any depth). |
| category_name | string | Category name (any depth, fuzzy). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"properties": {
"category_id": {
"type": "integer",
"description": "Exact category id (any depth)."
},
"category_name": {
"type": "string",
"description": "Category name (any depth, fuzzy)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Find brands newly OBSERVED in a category — the first date our daily sampling saw the brand there falls in the window. An observation signal, NOT confirmed first-ever entry (sparse re-sampling can resurface a long-present brand as 'new'). Use when the user asks 'new brands in Electronics', 'what brands just entered this category', 'emerging brands in Toys', 'category new entrants'.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| since_days | integer | How far back to look (default 30, max 180). |
| category_id | integer | Root category ID. |
| category_name | string | Category name (fuzzy match if category_id not provided). |
| max_avg_price | number | |
| min_avg_price | number | |
| brand_contains | string | |
| marketplace_id | integer |
Find brands in a category with the biggest recent growth in seller count and observations. Use when the user asks 'fastest growing brands in Toys', 'top growers in this category', 'which brands are trending up', or any category-scoped growth question.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| category_id | integer | Root category ID. |
| since_months | integer | Months to compare (default 3, max 6). Compares latest month vs earliest. |
| category_name | string | Category name (fuzzy match if category_id not provided). |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_prior_sellers | number | |
Find specific BRANDS within a category that have proven multi-seller demand but are still under-competed (a min-seller floor drops single-seller / brand-owner-only listings). Returns BRANDS — not niches or sub-categories. Use for 'undercompeted brands in <category>', 'low competition brands in Toys', 'which brands can I source in <category>'. Do NOT use for 'under-served niches', 'niches in <category>', or 'find a niche to enter' — those are SUBCATEGORY questions; use find_underserved_niches instead.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| category_id | integer | Root category ID to search within. |
| max_sellers | integer | Maximum unique sellers (default 20). |
| min_sellers | integer | Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand. |
| category_name | string | Category name (fuzzy match if category_id not provided). |
| max_avg_price | number | Maximum average price in USD. Omit for no cap. |
Pull a LIVE, on-demand snapshot of a single Amazon ASIN right now — current title, price, live offers and the sellers on the listing today — and return it alongside Webotee's historical brand and seller intelligence, including the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user gives a specific ASIN and wants its CURRENT/today's data rather than the pre-collected dataset (e.g. 'check ASIN B0... right now', 'who's on this listing today and at what price'). Every Amazon marketplace; one ASIN per call.
| Argument | Type | Description |
|---|---|---|
| asin* | string | The 10-character Amazon ASIN to collect live. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "The 10-character Amazon ASIN to collect live."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Map the competitive landscape for a brand or category root. Returns top 10 sellers by observed buybox days held, top 10 brands by winner-diversity HHI, plus week-over-week deltas. Use when the user asks 'who's winning this category?' or 'who controls the buybox here?'.
| Argument | Type | Description |
|---|---|---|
| brand | string | |
| seller_name | string | Exact seller name in the sellers list (case-insensitive). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_brand_count | number | |
| min_brand_count | number | |
| category_root_id | integer | |
| max_control_score | number | |
| min_control_score | number | |
| max_winner_diversity |
Evaluate a single ASIN for FBA sourcing. Returns composite sourcing score (0-100), 5-dimension breakdown (velocity, gating, friction, margin, brand_posture), estimated 30-day demand (units_30d_final + est_revenue_30d) with its source/badge_band/confidence, a data_coverage flag (full vs velocity_only — so a null demand reads as a coverage gap, not zero sales), star rating + review count (with a rating_coverage flag), brand-level FBA/Amazon dominance, and a red-flag list. Also returns the product brand, title, and price (or price range) plus the ASIN's fulfillment (FBA/FBM/AMZ + amz/fba pct). Use when the user asks 'should I buy this?', 'how fast does this sell?', or shares an ASIN and wants a sourcing recommendation.
| Argument | Type | Description |
|---|---|---|
| qty | integer | Optional purchase quantity for ROI sizing. |
| asin* | string | Amazon ASIN, 10-character alphanumeric. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"qty": {
"type": "integer",
"description": "Optional purchase quantity for ROI sizing."
},
"asin": {
"type": "string",
"description": "Amazon ASIN, 10-character alphanumeric."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Evaluate a brand for portfolio inclusion. Returns brand-level control posture, winner diversity (HHI), Amazon retail dominance %, FBA penetration %, catalog churn rate, total bought-past-month volume, estimated 30-day revenue, avg ship-by days, cross-brand operator count, plus the top 10 ASINs by composite sourcing score (each with product brand, title, price or price range, and fulfillment FBA/FBM/AMZ + amz/fba pct). Use when the user names a brand and asks 'is this worth carrying?', 'how does this brand look?', 'what is the churn rate?', or 'how fast does this brand ship?'.
| Argument | Type | Description |
|---|---|---|
| asin | string | Keep only this ASIN in top_asins. |
| brand* | string | Brand name (case-insensitive). |
| max_price | number | |
| min_price | number | |
| max_gating | number | |
| max_margin | number | |
| max_rating | number | |
| min_gating | number | |
Assess whether a category or niche (ANY depth — e.g. 'Terrariums') is winnable for a NEW private-label brand. Use for 'is X winnable for private label', 'should I private-label X', 'is the X niche good for a new brand', 'can I launch my own brand in X'. Returns a per-signal pass/fail breakdown and a Strong / Moderate / Weak verdict based on Amazon's footprint, seller fragmentation, demand, and price band.
| Argument | Type | Description |
|---|---|---|
| verdict_in | string | Comma-separated verdicts to keep (Strong/Moderate/Weak). |
| category_id | integer | Exact category id (any depth). |
| category_name | string | Category/niche name (any depth, fuzzy). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"properties": {
"verdict_in": {
"type": "string",
"description": "Comma-separated verdicts to keep (Strong/Moderate/Weak)."
},
"category_id": {
"type": "integer",
"description": "Exact category id (any depth)."
},
"category_name": {
"type": "string",
"description": "Category/niche name (any depth, fuzzy)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Return brands whose FBA buybox share is below or above a threshold. FBA share is computed as fba_buybox_days / total_buybox_days * 100 (percentage, 0-100). Use fba_share < 40 to find FBM-heavy brands (carriers hold real inventory) or fba_share > 80 for FBA-dominated brands. Supports sort by control_score (heat), unique_sellers, or brand_bought_past_month_30d. For a single NAMED brand's profile, evaluate_brand is the better first call — this tool is for screening lists.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| sort_by | string | Sort column (default control_score). |
| fba_share_op* | string | Comparison operator for FBA share threshold. |
| brand_contains | string | |
| marketplace_id* | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| fba_share_value* | number |
Return operators whose FBA buybox share is below or above a threshold. FBA share is 0-100 (percentage). For a single NAMED seller's profile, the operator-profile tools (operator_classifier / operator_top_brands) are the better first call — this tool is for screening lists. Use fba_share < 50 to find FBM-leaning operators (likely carrying real inventory) or fba_share > 80 for FBA-heavy flippers. Supports optional brand filter to narrow to operators selling a specific brand.
| Argument | Type | Description |
|---|---|---|
| brand | string | Optional — filter to operators selling this brand. |
| limit | integer | |
| sort_by | string | Sort column (default buybox_days). |
| seller_name | string | Exact seller/operator name (case-insensitive). |
| fba_share_op* | string | Comparison operator for FBA share threshold. |
| marketplace_id* | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_avg_rating | number |
Find brands experiencing high seller churn relative to their category. Returns brands where seller_churn_30d_delta_vs_cat_pp >= the specified threshold (default 5pp). Optionally filtered by category. Use when the user asks about 'brands losing sellers', 'high churn brands', or 'seller instability'.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | Max results (capped at 10). Default 10. |
| scope | string | tracked = only brands on the user's watchlist; universe = all brands. Default universe. |
| category | string | Category root name to filter (optional). |
| max_delta_pp | number | Max delta vs category in percentage points. Omit for no ceiling. |
| min_delta_pp | number | Min delta vs category in percentage points. Default 5. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Find brands where buybox concentration dropped over the last quarter — more sellers are entering, creating opportunity for new entrants. Use when the user asks 'brands losing control', 'deconcentrating brands', 'brands opening up to competition', 'gentrification opportunities', or any question about brands becoming less monopolized.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| since_weeks | integer | Window to compare (default 12, max 26). Compares first half vs second half. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number | |
| min_asin_count | number | |
| min_buybox_days | integer | Minimum observed buybox days to filter out inactive brands (default 30). |
Find operators (sellers) we FIRST OBSERVED selling recently — their earliest observation in our data falls in the window. An observation signal, NOT confirmed market entry: sparse sampling can surface a long-present seller the first time we see them. Different from top_expanding_operators (existing operators adding brands). Use when the user asks 'new sellers this month', 'who just started selling', 'newly seen operators', or any question about emerging/newly-observed sellers.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| min_brands | integer | Minimum brands to filter out trivial sellers (default 5). |
| since_days | integer | How far back to look (default 30, max 180). |
| seller_name | string | Exact seller name (case-insensitive). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_avg_rating | number | |
| min_avg_rating | number | |
Find where one product sits across the open web — a live cross-retailer price check — with every price anchored to Webotee's independently-observed Amazon buy-box. Give ONE identifier (asin, upc, gtin, or title + brand) and a mode: price_compare (default, all retailers vs the Amazon buy-box), cheaper (only sources below the buy-box), dropship (net margin after estimated Amazon fees), or supplier (wholesale-class sources). Returns each source's price, class, spread vs the buy-box, and a durability read from our 16-month history. The Amazon anchor also carries the product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). One product per call.
| Argument | Type | Description |
|---|---|---|
| upc | string | UPC code. |
| asin | string | Amazon ASIN (the strongest anchor). |
| gtin | string | GTIN code. |
| mode | string | price_compare (default) | cheaper | dropship | supplier. |
| brand | string | Brand (with title). |
| title | string | Product title (use with brand to resolve the ASIN). |
| source | string | Exact merchant/source name (case-insensitive). |
| max_price | number |
Find brands where a single operator controls 100 percent of observed buybox days. These are either gated/exclusive or operator-acquired brands. Use when the user asks 'brands with one seller', 'exclusive brands', 'single-seller brands', 'monopoly brands', or any question about brands with no competition.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| min_asins | integer | Minimum ASINs to filter out trivially small brands (default 10). |
| category_id | integer | Filter to a specific root category. Omit for all. |
| max_avg_price | number | Maximum average price in USD. Omit for no cap. |
| min_avg_price | number | Minimum average price in USD. Omit for no floor. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Given an Amazon ASIN, diagnose its business model (private-label / wholesale / arbitrage) and find real-world supplier, wholesale and arbitrage matches across the web, then return an HONEST sourcing read: a viability qualifier (green/yellow/red), the specific move + required differentiation, conservative economics, named risks (IP, tariffs, MOQ, saturation, gating, dropship policy) and validation steps. A credible lead generator, not get-rich advice. Scout+.
| Argument | Type | Description |
|---|---|---|
| asin* | string | The Amazon ASIN (10 chars). |
| marketplace_id | integer | Marketplace (2 = US). Default 2. |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "The Amazon ASIN (10 chars)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace (2 = US). Default 2."
}
}
}Find brands with low seller competition but real sales presence. The flagship sourcing discovery tool. Use when the user asks 'find brands with few sellers', 'low competition brands', 'undercompeted brands under $50', 'brands I could source with little competition', or any variant of 'find me something to sell'. Pass seed_brand when user mentions a reference brand ('brands like Ninja', 'low competition in the same category as OXO') to constrain results to the same root category.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | |
| seed_brand | string | Reference brand to derive category from. Results stay in the same root category. |
| category_id | integer | Filter to a specific root category ID. Overrides seed_brand if both given. |
| max_sellers | integer | Maximum unique sellers (competition ceiling). Default 20. |
| min_sellers | integer | Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand (the default 10–20 window: under-competed but real). |
| max_avg_price | number |
Find UNDER-SERVED NICHES — real SUBCATEGORIES with genuine demand but room to compete, ranked by private-label winnability from 2-year marketplace data. Returns CATEGORIES / sub-categories (e.g. 'Wireless Earbuds', 'Cable Organizers'), NEVER brands. This is the RIGHT tool for ANY niche-discovery question: 'under-served niches', 'niches in <category>', 'find a niche to enter', 'what niche should I sell in', 'underserved categories', 'gaps in <department>', 'where's the opportunity in <category>'. When the user names a department or category (e.g. 'electronics', 'home & kitchen'), pass it as category_name to scope the niches to that area. Do NOT use category_undercompeted_brands or find_undercompeted_brands for niche questions — those return BRANDS, not niches.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| niche | string | Exact niche (subcategory) name, case-insensitive. |
| price_max | number | Maximum average price in the marketplace's own currency. Omit for that marketplace's PL margin band (Amazon US: 70). |
| price_min | number | Minimum average price in the marketplace's own currency. Omit for that marketplace's PL margin band (Amazon US: 20). |
| category_id | integer | Root category id to scope to (overrides category_name). |
| competition | string |
Recommend ungate / arbitrage / avoid for an ASIN, with a 3-bullet rationale citing named metrics (gating_score, amz_retail_dominance_pct, fba_pct, brand_posture). Also returns the ASIN's product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for 'should I try to ungate this?' / 'how should I price this?'.
| Argument | Type | Description |
|---|---|---|
| asin* | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Check which of the 11 Amazon marketplaces a keyword was observed in Amazon's own autocomplete suggestions, with first/last observed dates and an example current suggestion-list position per marketplace. Use when a seller asks 'does anyone type X on Amazon Germany/Japan/…', compares keyword presence across countries, or plans a marketplace expansion (pair with brand_xmarket / operator_xmarket_presence). Exact-keyword match — not volumes, not rankings. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| keyword* | string | The exact keyword to check (e.g. 'electric toothbrush'). |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "The exact keyword to check (e.g. 'electric toothbrush')."
}
}
}Keywords observed in Amazon's own autocomplete suggestions for a seed term, per marketplace: the current suggestion list(s) for the seed's prefix (each term with its position 1-10 within that list) plus related observed vocabulary starting with the seed, with the marketplaces each term was observed in. Use for listing/backend keyword language, 'what do buyers type for X', or seeding niche/product research with real buyer phrases. No volume figures and no organic-ranking data — observed suggestion vocabulary only. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| seed* | string | Seed term (min 3 characters), e.g. 'electric toothbrush'. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"seed"
],
"properties": {
"seed": {
"type": "string",
"description": "Seed term (min 3 characters), e.g. 'electric toothbrush'."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Page 1 of Amazon US search for a keyword as last OBSERVED (head search terms from Amazon's own autocomplete, each observed about once a week): products in organic order with brand, price and their latest buy-box seller (AMZ = Amazon, FBA, FBM), the Sponsored Brands units in the page, the Amazon's Choice (Overall Pick) holder, Amazon's result count, who holds the page by brand and by seller, and the products that entered or left page 1 since the previous observation. Use for: who sells on page 1 for a search, which brands and resellers dominate it, who advertises on it. Dated weekly samples, not live and not volume figures (amazon_search_results reads the live page). Amazon US only.
| Argument | Type | Description |
|---|---|---|
| keyword* | string | The search term, e.g. 'chest rigs tactical'. |
| include_history | boolean | Add each weekly observation's ranks for the page's products. |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "The search term, e.g. 'chest rigs tactical'."
},
"include_history": {
"type": "boolean",
"default": false,
"description": "Add each weekly observation's ranks for the page's products."
}
}
}List the products this workspace keeps on a live refresh (set up with track_product), each with its current price, buy-box seller and fulfillment, stock state, seller count, the refresh interval and when it was last read, plus the most recent buy-box points (price and seller over time). Use when the user asks 'what changed on my tracked products', 'show my tracked ASINs', 'any buy-box changes'.
| Argument | Type | Description |
|---|---|---|
| points | integer | How many recent buy-box points per product (max 24). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"properties": {
"points": {
"type": "integer",
"default": 6,
"description": "How many recent buy-box points per product (max 24)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}Amazon Best Sellers list for one category, as Amazon shows it now: up to 100 products in rank order (rank, ASIN, title, price, rating, ratings count), the category's full breadcrumb path, and its subcategories with their URLs. With only marketplace_id (no url) it returns the marketplace's top-level best-seller categories, so you can walk the tree: root -> category -> subcategory, always with a URL from a previous answer. Use when the user asks what sells best in a category right now or wants a top-100 list. For keyword searches use amazon_search_results or search_products. Fresh lists take 15-35 seconds; Amazon refreshes them hourly, so recent lists return instantly. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| url | string | An Amazon Best Sellers URL (a category, or one from a previous answer's subcategories / categories / path). |
| pages | integer | 1 = ranks 1-50, 2 = ranks 1-100. |
| marketplace_id | integer | Without url: list this marketplace's top-level categories. 1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR. |
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "An Amazon Best Sellers URL (a category, or one from a previous answer's subcategories / categories / path)."
},
"pages": {
"type": "integer",
"default": 2,
"maximum": 2,
"minimum": 1,
"description": "1 = ranks 1-50, 2 = ranks 1-100."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Without url: list this marketplace's top-level categories. 1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR."
}
}
}LIVE Amazon offers for one product: every seller offering it right now, read from Amazon's 'All offers' view at request time (every page). Each offer has the seller and seller id, price, shipping, condition, buy box, FBA / FBM / Amazon, Prime, ships-from, the delivery promise and the seller's feedback; the answer adds the buy-box winner, offer counts by fulfillment, whether Amazon sells it, and the lowest new and used prices. Use when the user asks who sells a product right now, the current buy-box winner, the cheapest offer, or needs a fresh seller list before buying, sourcing or repricing. For history use product_dossier or asin_buybox_history. Takes 4-12 seconds. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| zip | string | US 5-digit ZIP: the offers as a shopper at that ZIP sees them (Amazon US only; first page of offers). |
| asin | string | 10-character Amazon ASIN. Provide asin or barcode. |
| barcode | string | UPC / EAN / GTIN / ISBN-13 instead of an ASIN. |
| include_used | boolean | Also list used, refurbished and collectible offers. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
Look up products by retail barcode: UPC-12, EAN-13 or GTIN-14. Use when the user gives a numeric product barcode (from a shelf tag, an invoice, a supplier price list, a wholesale catalog) and wants to know which Amazon or Walmart listing it maps to — e.g. 'what is UPC 050875825598 on Amazon', 'match these barcodes to ASINs'. Returns the matched products (best match first — priced and recently observed rows lead) with ASIN, brand, title, price, rating and image. A barcode we have not seen on a listing is searched on Amazon itself (10-20 seconds the first time). One barcode per call; for a list use bulk_product_lookup.
| Argument | Type | Description |
|---|---|---|
| barcode* | string | The numeric barcode (UPC-12 / EAN-13 / GTIN-14; 8-14 digits). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [
"barcode"
],
"properties": {
"barcode": {
"type": "string",
"description": "The numeric barcode (UPC-12 / EAN-13 / GTIN-14; 8-14 digits)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Show active MAP (Minimum Advertised Price) violations for products in the workspace. Use when the user asks 'MAP violations', 'who is selling below MAP', 'price violations today', 'are there any MAP breaches', or any MAP-enforcement question.
| Argument | Type | Description |
|---|---|---|
| brand | string | Filter to a specific brand. Omit for all workspace brands. |
| limit | integer | |
| last_seen_to | string | |
| first_seen_to | string | |
| retailer_name | string | Exact retailer name (case-insensitive). |
| brand_contains | string | Substring match on brand (use `brand` for an exact match). |
| last_seen_from | string | |
| first_seen_from | string | YYYY-MM-DD. |
| retailer_domain | string | Exact retailer domain (case-insensitive). |
Ranked discovery lists from observed Amazon buy-box data, 25 rows per page. kind=brand_movers: brands gaining (direction=up) or losing (down) distinct buy-box sellers fastest over 30 or 90 days. seller_movers: sellers whose buy-box footprint grew or shrank most. top_brands: brands ranked by buybox_days / sellers / control_score / asins / revenue / amazon_share, optionally within a root category_id. top_sellers: third-party sellers ranked by brands / buybox_days / asins / revenue (the biggest cross-brand operators). top_categories: categories ranked by asins / brands / heat / revenue / price / sellers (root categories, or the children of parent_id). Use to DISCOVER brands, sellers or categories - sourcing leads, brands under seller pressure, the biggest resellers - then drill in with evaluate_brand, seller_profile or category_metrics. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| page | integer | |
| sort | string | top_*: the ranking field (see description). |
| window | integer | movers: comparison window in days. |
| direction | string | movers: gaining (up) or losing (down). |
| parent_id | integer | top_categories: list this category's children. |
Who's competing with the seller on their OWN products. Pass an ASIN from your catalog to see the full competitor list for that listing (who wins the buy-box, FBA/FBM, observed price, how long they've been on it) plus your own buy-box / undercut status. Omit the ASIN to get your most-contested products (most competing sellers / where you're being undercut). Requires a connected store (Starter+). Use for 'who am I competing with', 'am I losing the buy-box', 'who else sells B0...', 'where am I under pressure'.
| Argument | Type | Description |
|---|---|---|
| asin | string | Optional — a specific ASIN from your catalog. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [],
"properties": {
"asin": {
"type": "string",
"description": "Optional — a specific ASIN from your catalog."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}What to source NEXT, adjacent to what the seller already sells. Seeds Webotee's undercompeted-brand and underserved-niche engines from the seller's OWN connected catalog (their dominant brands and categories), excluding brands they already carry. Requires a connected store (Starter+). Use for 'what should I source next', 'expand my catalog', 'adjacent opportunities', 'what else could I sell'.
| Argument | Type | Description |
|---|---|---|
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [],
"properties": {
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}The seller's OWN connected Amazon catalog fused with Webotee market intelligence. Each product shows EXACT account data (your price, your inventory, FBA/FBM, listing status) alongside OBSERVED/ESTIMATED market data (sourcing score, the observed market buy-box price, how many sellers are on the listing, estimated 30-day units, cross-marketplace spread) and a price_vs_market read (below_market / at_market / above_market). Requires a connected store (Starter+). Use when the seller asks about their own products, 'how am I priced vs the market', 'which of my products are under pressure', or 'show my catalog'.
| Argument | Type | Description |
|---|---|---|
| sort | string | Ordering: score (default), undercut, price, inventory. |
| brand | string | Optional — only products of this brand. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [],
"properties": {
"sort": {
"enum": [
"score",
"undercut",
"price",
"inventory"
],
"type": "string",
"default": "score",
"description": "Ordering: score (default), undercut, price, inventory."
},
"brand": {
"type": "string",
"description": "Optional — only products of this brand."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Store-level summary of the seller's connected Amazon catalog: number of products tracked, distinct brands, FBA vs FBM split, total on-hand inventory units (EXACT, from the account), average Webotee sourcing score, how many products are currently undercut, and how many have a cross-marketplace (Walmart) opportunity. Requires a connected store (Starter+). Use for 'how is my store doing', 'summarise my catalog', or a dashboard overview.
| Argument | Type | Description |
|---|---|---|
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [],
"properties": {
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}Given one or more operator (seller) names, return the brands they carry ranked by seller competition level. Use when the user asks 'which brands sold by these operators have the least competition', 'out of these operators, show me brands with fewest sellers', 'low-competition brands for operator X', or any follow-up that chains operator names to brand-level competition metrics.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort by competitor count: 'asc' (least competition first, default) or 'desc'. |
| brand | string | Exact brand (case-insensitive). |
| limit | integer | |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number | |
| min_asin_count | number | |
| operator_names* | array |
For ONE operator (seller), find the ASINs where it's losing the buy-box — it carries the listing but holds less than `max_buybox_share_pct` of the buy-box — ranked by estimated 30-day revenue at risk. Each leak returns who's winning the box, the operator's vs the winner's sanitized price and the gap, how many sellers are on the listing, a `situation` (price_gap | tied_price | amazon_in_box | reseller_swarm), a `suggested_action` (reprice_to_win | enable_fba | defend_match_only | evaluate_or_exit), and a `suggested_target_price` when the box is winnable on price. Totals include the recoverable price-gap-only revenue. Use when the user asks 'where is seller X losing the buy-box', 'X's buy-box leaks', 'which ASINs should X reprice', 'where is X leaving money on the table', or 'what's X's revenue at risk'. Sortable by revenue-at-risk (default), price gap, buy-box share, or listing revenue.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort the leaks: revenue_at_risk (default), price_gap_pct (biggest recoverable gap), buybox_share (lowest first), or listing_revenue. |
| limit | integer | Leaks to return (default 25, max 100). This tool pages. |
| min_price | number | Only ASINs whose listing price >= this (skip pennies). |
| situation_in | string | Comma-separated situations to keep (price_gap, tied_price, amazon_in_box, reseller_swarm). |
| operator_name* | string | Seller/operator name. |
Show which product categories an operator dominates. Returns categories ranked by the operator's brand count and observed buybox days in each. Use when the user asks 'what categories does this seller focus on', 'operator category breakdown', 'where does Amazon Warehouse dominate', or any category-scoped operator question.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| category_name | string | Exact category name (case-insensitive). |
| operator_name* | string | Seller/operator name. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_brand_count | number | |
| max_total_asins | number | |
| min_brand_count | number | |
| min_total_asins | number | |
Label what kind of operator a seller is — amazon, brand-direct, likely-authorized-retailer, arbitrage, or reseller — from our cross-brand operator signals (how many brands they span, their fulfilment mix, their primary brand). Use when the user asks 'what kind of seller is this', 'is this an authorized retailer or an arbitrage seller', 'classify this operator'. Heuristic label, not a legal determination. Amazon US/UK.
| Argument | Type | Description |
|---|---|---|
| operator_name* | string | Seller/operator name. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}ASIN-level buy-box head-to-head between two operators (sellers). For the ASINs BOTH carry (contested), returns who holds the buy-box (winner), each operator's buy-box share, their sanitized average prices and the price gap, how many OTHER sellers are on the listing, whether Amazon holds the box, and a `situation` tag (amazon_in_box | reseller_swarm | tied_price | price_gap) — plus operator_a's estimated 30-day revenue-at-risk. Also returns each side's WHITESPACE: high-revenue ASINs that operator wins which the OTHER doesn't carry (expansion targets). Use when the user asks 'compare seller A vs seller B', 'where do these two sellers overlap / compete', 'who wins the buy-box between them', 'show me the head-to-head', or 'what does A sell that B doesn't'. Sortable by revenue-at-risk (default), price gap, or share gap.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort the contested list: revenue_at_risk (operator_a's 30d revenue at risk, default), price_gap (abs A-vs-B price gap), or share_gap (abs buy-box share gap). |
| brand | string | Optional — scope the comparison to a single brand's ASINs (catalog sizes, contested, and whitespace are all limited to that brand). Omit for all brands. |
| limit | integer | Contested ASINs to return (default 25, max 100). This tool pages. |
| operator_a* | string | First operator/seller name (the focal seller — revenue-at-risk + situation are from A's view). |
| operator_b* |
Operator concentration (HHI) across a set of ASINs or a brand's catalog — reveals when the same operator quietly controls many of the 'independent' listings. Returns the HHI, a concentration label, and the top operators with how many listings each dominates. Use for private-label fragmentation checks: 'how concentrated is this niche', 'who controls this brand's listings', 'is one operator running most of these'. Amazon US/UK. Optional filters (all default to no filter): min/max hhi (gates the whole analysis by its concentration index); on the top_operators list — operator (exact, case-insensitive) + operator_contains, min/max share_pct, min/max listings_controlled.
| Argument | Type | Description |
|---|---|---|
| asins | array | ASIN set to analyze. |
| brand | string | Or a brand whose catalog to analyze. |
| limit | integer | |
| max_hhi | number | |
| min_hhi | number | Only return the analysis if its HHI >= this (else empty top_operators). |
| operator | string | Keep only this operator (exact, case-insensitive) in top_operators. |
| max_share_pct | number | |
Show brands an operator recently stopped selling (churn signal). Use when the user asks 'what brands did this seller drop', 'operator churn', 'brands lost by X', or any question about an operator shrinking their catalog.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand (case-insensitive). |
| limit | integer | |
| since_days | integer | Window to compare (default 30, max 180). Brands present before but absent in the last since_days. |
| first_seen_to | string | |
| operator_name* | string | Seller/operator name. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | |
| last_seen_week_to |
Show brands an operator recently started selling. Use when the user asks 'what new brands did this seller pick up', 'operator new brands', 'what is Amazon Warehouse selling now that it wasn't before', or any question about an operator expanding their catalog.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand (case-insensitive). |
| limit | integer | |
| since_days | integer | How far back to look for new brands (default 30, max 180). |
| first_seen_to | string | |
| operator_name* | string | Seller/operator name. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | YYYY-MM-DD lower bound on first_seen. |
Operators newly OBSERVED on a brand in a recent window — counted at BRAND level: a seller's FIRST observation anywhere across the brand's ASINs falls in the window. This is coverage-robust (a long-present seller was almost certainly seen on some ASIN earlier, so they correctly drop out) — a trustworthy directional 'new on the brand' count, not the inflated per-ASIN number. Still first-OBSERVED, not provably first-to-market. Returns each operator with first_observed, how many of the brand's ASINs we've seen them on, and whether still active. Use for 'who's new on <brand>', 'who's newly showing up on my brand', 'recent sellers on <brand>'. Amazon US/UK. since_days already bounds first_observed below; optional filters (all default to no filter): operator (exact, case-insensitive) + operator_contains, first_observed_from/_to, min/max n_asins_on_brand, min/max total_days_seen, min/max observed_buybox_days, still_active (true/false).
| Argument | Type | Description |
|---|---|---|
| brand* | string | The brand to watch. |
| limit | integer | |
| operator | string | Exact operator/seller name (case-insensitive). |
| since_days | integer | Window in days (default 30, max 180). |
| still_active | boolean | Keep only operators last seen within 7 days (true) or not (false). |
| marketplace_id |
The arbitrage sourcing feed: given an ASIN (or a seller/operator name), find the OTHER ASINs the operators on that listing also resell, ranked by sourcing fit (our composite sourcing score) then estimated 30-day sales. De-duped against the ASINs the user already tracks, so it surfaces NEW candidates. Use when the user says 'what else does this seller carry', 'find more like this from the same operators', 'arbitrage leads from this ASIN's sellers'. Each candidate ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). Amazon US/UK. Optional filters (all default to no filter): min/max sourcing_score, est_units_30d, buybox_avg_price; resold_by_contains; the shared product/fulfillment block (product_brand, product_title_contains, min/max_price, fulfillment_in, amz/fba pct).
| Argument | Type | Description |
|---|---|---|
| asin | string | An ASIN whose operators to expand from. |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| operator_name | string | Or a seller/operator name directly. |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in |
Show the ASINs an operator wins the buybox on most often, ranked by ESTIMATED 30-day sales by default. For each ASIN it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the product's sales estimate weighted by the operator's buy-box share) plus the operator's BUYBOX SHARE (percent of observed days it held the buybox; normalized, not raw days). Sortable by est_sales (default), observed buybox days won, price, or days seen. Use when the user asks 'what ASINs does this seller win on', 'top ASINs for operator X', 'what does this seller sell the most of', 'best products for this seller', or any ASIN-level operator drill-down. Each ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct).
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| sort | string | Sort order: est_sales (estimated 30-day revenue, default), buybox_days (observed buybox days won), price, or days_seen. |
| limit | integer | Number of ASINs to return (default 10, max 50). |
| max_price | number | |
| min_price | number | |
| est_basis_in | string | Comma-separated sales-estimate sources to keep. |
Show the brands an operator sells the most of, ranked by ESTIMATED 30-day sales by default. For each brand the operator carries it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the estimated sales of the ASINs the operator wins for that brand, weighted by its buy-box share), the number of the brand's ASINs the operator wins, and observed buybox days. Use when the user asks 'what brands does this seller sell the most of', 'top brands for operator X', 'which brands make this seller the most money', or any brand-level operator drill-down by sales. For brand competition (fewest sellers) instead of sales, use operator_brands_by_competition.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort order: est_sales (estimated 30-day revenue, default), est_units, buybox_days (observed buybox days), or asin_count. |
| brand | string | Exact brand (case-insensitive). |
| limit | integer | |
| operator_name* | string | Seller/operator name. |
| brand_contains | string | |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Check whether an operator sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace brand count, ASIN count, and observed buybox days. Use when the user asks 'does this seller sell on Walmart too', 'cross-marketplace presence', 'is this operator on Amazon UK', or any multi-marketplace operator question.
| Argument | Type | Description |
|---|---|---|
| operator_name* | string | Seller/operator name. |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"operator_name": {
"type": "string",
"description": "Seller/operator name."
}
}
}Save a reusable per-model research workflow (a 'playbook') the user can re-run or schedule. Provide a template_key (one of: brand_watch, new_brand_radar, replenishment_watch, arbitrage_feed, defend_my_niche, find_my_next_niche, brand_defense_daily, expansion_radar, dropship_watch, spread_hunter, map_sweep, operator_network_expose, gating_risk_guardian) with its scope, OR custom steps. scope holds the inputs every step shares (e.g. {"brand":"Nike"} or an ASIN). Use when the user says 'save this as a weekly check', 'make a playbook for ...', 'automate this research'.
| Argument | Type | Description |
|---|---|---|
| name* | string | The playbook's label. |
| scope | object | Shared inputs for the steps, e.g. {"brand":"Nike"}. |
| steps | array | Custom ordered [{tool,args}] (instead of a template). |
| schedule | string | Run cadence (default = template's or manual). |
| template_key | string | Built-in template to seed from. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The playbook's label."
},
"scope": {
"type": "object",
"description": "Shared inputs for the steps, e.g. {\"brand\":\"Nike\"}."
},
"steps": {
"type": "array",
"items": {
"type": "object"
},
"description": "Custom ordered [{tool,args}] (instead of a template)."
},
"schedule": {
"enum": [
"manual",
"daily",
"weekly"
],
"type": "string",
"description": "Run cadence (default = template's or manual)."
},
"template_key": {
"enum": [
"brand_watch",
"new_brand_radar",
"replenishment_watch",
"arbitrage_feed",
"defend_my_niche",
"find_my_next_niche",
"brand_defense_daily",
"expansion_radar",
"dropship_watch",
"spread_hunter",
"map_sweep",
"operator_network_expose",
"gating_risk_guardian"
],
"type": "string",
"description": "Built-in template to seed from."
}
}
}List the workspace's saved playbooks (name, schedule, last run) and the built-in templates available. Use when the user asks 'what playbooks do I have', 'show my saved workflows', 'what automations are set up'.
| Argument | Type | Description |
|---|---|---|
| active | boolean | Only active (true) or only paused (false) playbooks. |
| schedule_in | string | Comma-separated cadences to keep (manual/daily/weekly). |
| last_run_at_to | string | |
| template_key_in | string | Comma-separated template keys to keep. |
| last_run_at_from | string | YYYY-MM-DD; only playbooks last run on/after this. |
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"description": "Only active (true) or only paused (false) playbooks."
},
"schedule_in": {
"type": "string",
"description": "Comma-separated cadences to keep (manual/daily/weekly)."
},
"last_run_at_to": {
"type": "string"
},
"template_key_in": {
"type": "string",
"description": "Comma-separated template keys to keep."
},
"last_run_at_from": {
"type": "string",
"description": "YYYY-MM-DD; only playbooks last run on/after this."
}
}
}Run a saved playbook right now and return its digest (also saved to the in-app inbox). Use when the user says 'run my <name> playbook', 'check my brand watch now', 'run that workflow'.
| Argument | Type | Description |
|---|---|---|
| name* | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
}
}Set how often a saved playbook runs automatically (manual, daily, or weekly). Use when the user says 'run this weekly', 'schedule my playbook daily', 'stop the automatic runs' (manual).
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| schedule* | string |
{
"type": "object",
"required": [
"name",
"schedule"
],
"properties": {
"name": {
"type": "string"
},
"schedule": {
"enum": [
"manual",
"daily",
"weekly"
],
"type": "string"
}
}
}Full dossier for ONE Amazon product, by ASIN or by retail barcode (UPC / EAN / GTIN / ISBN-13): current price, buy-box seller and condition, every current seller (price, FBA/FBM/Amazon, delivery), stock state, BSR and category, rating and review count, Amazon's bought-past-month badge, dimensions and weight, plus observed history - price changes, stock changes, sub-daily buy-box points for frequently refreshed products, rating history. Set include_history=true for the long series (per-seller offer history and the daily buy-box price back to 2023 on Amazon US, BSR history). Use when the user has a specific product and asks 'what does this sell for now', 'who is on this listing', 'has the price moved', 'is it in stock', 'analyse this ASIN', or gives a barcode from a supplier list. Answers from stored observations in milliseconds; refresh=true reads the live Amazon page (10-30 seconds). Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| asin | string | 10-character Amazon ASIN. Provide asin or barcode. |
| barcode | string | UPC-12 / EAN-13 / GTIN-14 / ISBN-13 instead of an ASIN. Resolved through observed listings, then Amazon's own search. |
| refresh | boolean | Read the live Amazon page now instead of the stored snapshot. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| include_content |
The observed page-content record for one Amazon ASIN: description (with its source — prose vs 'About this item' bullets vs brand A+ content), feature bullets, breadcrumb category path, image-gallery URLs, variation count + parent ASIN, stock state, and first/last-observed timestamps. Set include_reviews=true to append the featured customer reviews shown on the page (rating, title, trimmed text, verbatim date, verified flag, helpful votes; reviewer names are not stored, so author is always null). Use when the user asks what a product's page says or shows — its description, bullets, images, categories, variations — or wants the reviews on a listing. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| asin* | string | The 10-character Amazon ASIN. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| include_reviews | boolean | Append the stored featured reviews (max 12). Default false — reviews are opt-in to keep the payload small. |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "The 10-character Amazon ASIN."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"include_reviews": {
"type": "boolean",
"default": false,
"description": "Append the stored featured reviews (max 12). Default false — reviews are opt-in to keep the payload small."
}
}
}Risk + protection assessment for an ASIN or brand. Returns composite risk score (0-100), recent price-drop / MAP events (≤10: a buy-box price at least 10% below the product's usual price, won by a seller other than the brand's own store; each with the ASIN's product brand, title, price or price range and fulfillment FBA/FBM/Amazon), unauthorized seller list (≤10), and 1-3 recommended actions. Use for 'flag risk events on my brand' or 'is this ASIN risky?' style prompts.
| Argument | Type | Description |
|---|---|---|
| asin | string | |
| days | integer | Lookback window for MAP events. Default 30. |
| brand | string | |
| kind_in | string | Comma-separated flagged-event kinds to keep (e.g. map_violations,amazon_dominated). |
| max_count | number | |
| max_price | number | |
| min_count | number | |
| min_price | number | |
| severity_in | string |
Free-text keyword search over Amazon product titles + descriptions. Use when the user names a PRODUCT TYPE or keywords (e.g. 'stainless steel water bottle', 'cat litter box', 'magnetic phone mount') rather than a specific brand, category, or ASIN. Returns the top matching products ranked by relevance with brand, price, 30-day demand, fulfillment (FBA/Amazon/FBM) and rating. Optional filters narrow the result by any returned field: product_brand, min/max_price, fulfillment_in (FBA/FBM/AMZ), min/max demand, and min/max rating.
| Argument | Type | Description |
|---|---|---|
| keywords* | string | Free-text product keywords, e.g. 'stainless steel water bottle'. |
| max_price | number | |
| min_price | number | |
| max_rating | number | |
| min_rating | number | |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer |
The stored Amazon SELLER PROFILE for one seller - by seller id (the 'A...' code in /sp?seller=... or the seller_id on an offer) or by the seller/operator name the other tools use. RETURNS the seller's star rating, lifetime and 12-month rating counts, positive-feedback % (with its period), feedback per period (30 d / 90 d / 12 m / lifetime: average rating + count), the rating histogram, up to 5 recent feedback entries (date / rating / struck ONLY - never a buyer's name or text), the business block where the seller publishes one on Amazon (legal name, registration / VAT numbers, address, phone, e-mail, representative; null on au/ca), and tracking (since when and how often Webotee has observed the seller). include_history=true adds the rating-change points and storefront-size points, oldest first, UTC. USE WHEN the user asks who a seller is, how it is rated, whether its rating moved, or wants the legal entity behind a storefront. It reads Webotee's seller store (re-read about every 14 days) - it never fetches Amazon live; a seller not stored yet answers not_yet_tracked. For what a seller SELLS use the operator_* tools. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| seller_id | string | Amazon seller id: 'A' + 8-24 letters/digits. Give this OR operator_name. |
| operator_name | string | The seller / operator display name as the operator_* tools return it (resolved to a seller id on the chosen marketplace; the id wins when both are given). |
| history_points | integer | include_history=true: the latest N change points per series (1-200). |
| marketplace_id | integer |
Record the user's cost basis (landed unit cost) for an ASIN so later checks can flag when the buy box drops below their cost and compute true net spread; the saved/cleared confirmation also echoes the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user says 'my cost on B0... is $12', 'set my cost basis', 'I pay $X for this'. One ASIN per call; pass cost 0 to clear.
| Argument | Type | Description |
|---|---|---|
| asin* | string | The 10-character ASIN. |
| cost_floor* | number | Your landed unit cost (marketplace currency). 0 clears it. |
| marketplace_id | integer | Marketplace (2 = Amazon US). |
{
"type": "object",
"required": [
"asin",
"cost_floor"
],
"properties": {
"asin": {
"type": "string",
"description": "The 10-character ASIN."
},
"cost_floor": {
"type": "number",
"description": "Your landed unit cost (marketplace currency). 0 clears it."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace (2 = Amazon US)."
}
}
}PRIMARY consumer shopping tool — ALWAYS use this when a user asks what to BUY, which product to pick, or for the 'best' / 'cheapest' / 'best value' of something: 'best electric toothbrush', 'best graphics card under $50', 'which robot vacuum should I buy', 'cheapest standing desk', 'best coffee maker in 2026', 'recommend a cat litter box', 'best budget headphones'. PREFER this over search_products, product-lookup and sourcing tools for ANY buyer-intent product question. Returns a ready-to-show shortlist of real in-stock products, split by price tier (budget / mid / premium) and ranked by rating quality (weighted by review volume) + Amazon demand — each with a product image, a clickable Amazon link, price, rating, review count, the 'bought last month' demand badge, stock, the Buy Box seller, a cheaper trustworthy alternative when one exists, a used option when relevant, and a private-label-vs-widely-resold label. Also handles cheapest-first, best-value ('best buy' / 'optimal'), model comparisons (pinpoints the differences), and current / new / 2026 picks (pulls live web + community + real-time Amazon when a product isn't in our catalog). Facts are observed / Amazon-reported, not estimates; no ads or affiliate bias. (Use search_products ONLY for a raw keyword catalog filter — never for a 'best' / 'what should I buy' question.)
| Argument | Type | Description |
|---|---|---|
| sort | string | 'best' = rating-first per class/tier (default); 'cheapest' = lowest-price-first; 'value' = best quality-per-dollar ('best buy'/'optimal'). Auto-detected from the query. |
| query* | string | What to buy, e.g. 'best electric toothbrush for sensitive gums'. |
| keywords | string | Core product keywords to search (product noun + essential attributes), no 'best'/brand. |
A short guide to what Webotee can do and which tools to use, by selling model: wholesale and online arbitrage, private label, brand owners, and agencies. Use at the start of a session, when the user asks 'what can you do with Webotee', or when they only know one tool.
| Argument | Type | Description |
|---|---|---|
| model | string |
{
"type": "object",
"properties": {
"model": {
"enum": [
"wholesale",
"online_arbitrage",
"private_label",
"brand_owner",
"agency",
"all"
],
"type": "string",
"default": "all"
}
}
}Find sellers (operators) expanding into the most NEW brands in a recent window. Use when the user asks 'operators expanding into new brands', 'sellers growing fastest by brand count', 'who is moving into new brands this month', or any cross-cutting operator question without a specific seller named.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| seller_name | string | Exact seller/operator name (case-insensitive). |
| window_days | integer | Days back for 'new' brands (default 30, max 90). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_avg_rating | number | |
| min_avg_rating | number | |
| min_new_brands | integer | Minimum new-brand count to surface (default 3). |
| max_total_asins | number | |
Find top sourcing-pick ASINs across the entire catalog with optional filters: max retail price, min retail price, category, brand, exclude gated, exclude Amazon private label. Use when the user asks 'top sourcing picks', 'best ASINs to source', 'ASINs under $X with rising demand', 'fastest growing ASINs', or any cross-cutting question where they have NOT named a specific entity yet. Each pick carries product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon) alongside the sourcing scores.
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| brand | string | |
| limit | integer | Number of products to return (default 10, max 50). |
| scope | string | tracked = only ASINs from brands on the user's watchlist; universe = all. Default universe. |
| category | string | |
| max_rating | number | |
| min_rating | number | |
| asin_contains | string | |
Find top brands by 90-day unit velocity (brand_velocity_90d_units_day). Optional filters: scope (tracked = user's watchlist, universe = all), category, minimum velocity, exclude Amazon private label, exclude gated. Use when the user asks 'fastest selling brands', 'top velocity brands', 'brands I track by velocity', 'what brands move the most units?', or 'best selling brands in [category]'. When the user says 'my brands' or 'brands I track', set scope=tracked.
| Argument | Type | Description |
|---|---|---|
| brand | string | Exact brand match (case-insensitive). |
| limit | integer | Max results (capped at 10). Default 10. |
| scope | string | tracked = only brands on the user's watchlist; universe = all brands. Default universe. |
| category | string | Category root name to filter (optional). |
| min_velocity | number | Minimum units/day threshold (optional). |
| exclude_gated | boolean | Exclude brands gated to 3P sellers. Default true. |
| brand_contains | string | |
| marketplace_id | integer |
Keep Amazon products on a frequent live refresh (every 2-24 hours, depending on plan) for 30 days, so their buy-box price, buy-box seller, stock state and offer count are re-read and kept as a time series. Read the results with list_tracked (all tracked products) or product_dossier (one product). action=stop removes products from your tracked list. Use when the user says 'track this ASIN', 'watch the buy box on these', 'monitor these competitor listings'. No e-mail alerts - ask for the latest points instead. Amazon marketplaces only.
| Argument | Type | Description |
|---|---|---|
| asins* | array | One or more 10-character ASINs. |
| action | string | |
| interval | string | Refresh interval (your plan sets the shortest: Starter 24h, Scout 12h, Scout Pro 4h, Scout + Protect 2h). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
{
"type": "object",
"required": [
"asins"
],
"properties": {
"asins": {
"type": "array",
"items": {
"type": "string"
},
"description": "One or more 10-character ASINs."
},
"action": {
"enum": [
"track",
"stop"
],
"type": "string",
"default": "track"
},
"interval": {
"enum": [
"2h",
"4h",
"12h",
"24h"
],
"type": "string",
"description": "Refresh interval (your plan sets the shortest: Starter 24h, Scout 12h, Scout Pro 4h, Scout + Protect 2h)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}List the sellers winning a brand's buy box — the resellers and arbitrage operators you're up against — each classified (authorized-retailer / arbitrage / Amazon / brand-direct / reseller). If you've saved an authorized list (authorized_seller_set) it instead flags the UNAUTHORIZED sellers. Use when the user asks 'which operators dominate the buy box on <brand>', 'who else is selling my brand', 'unauthorized sellers on Nike', 'find rogue sellers', or any brand buy-box / protection question.
| Argument | Type | Description |
|---|---|---|
| brand* | string | Brand name (case-insensitive). |
| limit | integer | |
| seller_name | string | Exact seller name (case-insensitive). |
| last_seen_to | string | |
| first_seen_to | string | |
| max_avg_price | number | |
| min_avg_price | number | |
| last_seen_from | string | |
| marketplace_id |
Create or add to a saved tracking list the user can monitor over time. list_type is one of asin, brand, seller, niche; name is the user's label for the list; items are the identifiers to track (ASINs, brand names, seller names, or niche keys). Captures a baseline of the current observed state so a later 'what changed' check can show new sellers and score moves. Use when the user says 'track these ASINs', 'add Nike to my brand watchlist', 'start monitoring ...'.
| Argument | Type | Description |
|---|---|---|
| name* | string | The list's label (e.g. 'Q4 arbitrage candidates'). |
| items* | array | Identifiers to add. |
| list_type* | string | asin | brand | seller | niche |
| marketplace_id | integer | Marketplace (2 = Amazon US). |
{
"type": "object",
"required": [
"list_type",
"name",
"items"
],
"properties": {
"name": {
"type": "string",
"description": "The list's label (e.g. 'Q4 arbitrage candidates')."
},
"items": {
"type": "array",
"items": {
"type": "string"
},
"description": "Identifiers to add."
},
"list_type": {
"enum": [
"asin",
"brand",
"seller",
"niche"
],
"type": "string",
"description": "asin | brand | seller | niche"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace (2 = Amazon US)."
}
}
}Resolve a natural-language watchlist request into concrete ASINs the user can add. Use when the user says 'watch this brand', 'alert me when X loses a seller', 'add Nike to my watchlist', or any watchlist-creation intent. Returns matching ASINs with current scores plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share) so the user can confirm which to add.
| Argument | Type | Description |
|---|---|---|
| asin | string | Specific ASIN to add. If provided, brand is ignored. |
| brand | string | Brand name to find watchable ASINs for. |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| asin_contains | string | |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
Show what changed on the user's sourcing watchlist since last check. Returns each tracked ASIN with its score delta plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on my watchlist', 'watchlist updates', 'any changes this week', or any watchlist-status question.
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| limit | integer | |
| max_price | number | |
| min_price | number | |
| since_days | integer | How far back to look for changes (default 7, max 30). |
| asin_contains | string | |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. One marketplace per call. |
Show what changed on a saved tracking list versus its captured baseline — new sellers observed on the tracked ASINs and sourcing-score moves. Each changed ASIN also carries product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on <list>', 'any updates on my watchlist', 'new sellers on the ASINs I track'. Re-run watchlist_add to reset the baseline to the current state.
| Argument | Type | Description |
|---|---|---|
| asin | string | Only the change row for this exact ASIN. |
| name* | string | The list name to diff. |
| list_type | string | Defaults to asin. |
| max_price | number | |
| min_price | number | |
| asin_contains | string | |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
List the workspace's saved tracking lists (name, type, item count, whether a baseline is set). Use when the user asks 'what am I tracking', 'show my watchlists', 'my saved lists'.
| Argument | Type | Description |
|---|---|---|
| list_type_in | string | Comma-separated list types to keep (asin/brand/seller/niche). |
| updated_at_to | string | |
| max_item_count | number | |
| min_item_count | number | Only lists with at least this many items. |
| updated_at_from | string | YYYY-MM-DD; only lists updated on/after this. |
{
"type": "object",
"properties": {
"list_type_in": {
"type": "string",
"description": "Comma-separated list types to keep (asin/brand/seller/niche)."
},
"updated_at_to": {
"type": "string"
},
"max_item_count": {
"type": "number"
},
"min_item_count": {
"type": "number",
"description": "Only lists with at least this many items."
},
"updated_at_from": {
"type": "string",
"description": "YYYY-MM-DD; only lists updated on/after this."
}
}
}Remove items from a saved tracking list, or delete the whole list. Provide list_type + name; give items to drop just those, or omit items to delete the entire list. Use when the user says 'stop tracking ...', 'remove ... from my watchlist', 'delete my ... list'.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| items | array | Items to remove; omit to delete the list. |
| list_type* | string |
{
"type": "object",
"required": [
"list_type",
"name"
],
"properties": {
"name": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "string"
},
"description": "Items to remove; omit to delete the list."
},
"list_type": {
"enum": [
"asin",
"brand",
"seller",
"niche"
],
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| sort | string | 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 | integer | |
| max_price | number | |
| min_price | number | |
| asin_contains | string |
Bulk web-wide (open-web / off-Amazon) price + MAP findings across your whole watchlist, in one call — reads already-collected results, does not run a live scan. Returns every tracked ASIN with its open-web source count, cheapest off-Amazon price (+ the domain), how many web sources violate MAP, how many are unauthorized sellers, the Amazon buy-box anchor price, and how much cheaper the web is vs Amazon. ASINs not yet scanned show 0 sources / never-scanned. Use for 'where is my whole watchlist cheaper off Amazon', 'web-wide MAP across everything I track', or 'which tracked products are undercut on the open web'. For a live single-product cross-retailer check use find_product_across_web instead.
| Argument | Type | Description |
|---|---|---|
| asin | string | Exact ASIN match. |
| sort | string | Order: web_violations (most MAP breaches first), cheapest_web_price, web_savings_vs_amazon (biggest off-Amazon discount first), last_scan. |
| limit | integer | |
| asin_contains | string | |
| product_brand | string | Exact product brand (case-insensitive). |
| marketplace_id | integer | Marketplace to scope the watchlist to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. |
Search the web (Google, via Serper) for a query — returns title + link + snippet. Use for supplier / wholesale / distributor research and review-gap articles.
| Argument | Type | Description |
|---|---|---|
| count | integer | Max results (default 10, cap 20). |
| query* | string | The search query. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"count": {
"type": "integer",
"default": 10,
"description": "Max results (default 10, cap 20)."
},
"query": {
"type": "string",
"description": "The search query."
}
}
}The user's Webotee plan and usage: plan and price, subscription status and renewal or end date, AI Connect calls used today against the plan's daily limit, today's use of the live tools (live offers, live product refreshes, live searches, best-seller lists, cross-web checks), and how much of this month's live-data allowance is used. Use when the user asks about their plan, limits, remaining calls or why a live tool was paused.
No arguments.
{
"type": "object",
"properties": {}
}Check the status of a live Amazon refresh kicked off for an ASIN (returns its current snapshot when ready). job_id is the ASIN. Use after a tool says a live refresh is collecting.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | The job id (the ASIN being refreshed). |
| marketplace_id | integer | Marketplace (2 = Amazon US). Default 2. |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job id (the ASIN being refreshed)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace (2 = Amazon US). Default 2."
}
}
}Cross-marketplace (Amazon vs Walmart) pricing comparison. Returns matched pairs from mv_product_identity with current Amazon price, current Walmart price, delta %, and a coarse Amazon-FBA profitability check. Each pair also carries the Amazon ASIN's product brand, title and catalog price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for arbitrage / sourcing questions ('cheaper on Walmart?'). Single-ASIN or by-brand.
| Argument | Type | Description |
|---|---|---|
| asin | string | |
| brand | string | |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | Amazon-side marketplace for the comparison (Walmart US is always the other side). 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_amazon_price | number | |
| min_amazon_price | number | |
| max_walmart_price | number | |
| min_walmart_price |
| max_days_seen | number |
| min_days_seen | number |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| last_seen_from | string |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | YYYY-MM-DD. |
| max_seller_count | number |
| min_seller_count | number |
| max_buybox_avg_price | number |
| min_buybox_avg_price | number |
| seller_name_contains | string |
| product_brand_contains | string |
| product_title_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number | Only sellers with at least this many observed buy-box days. |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "ASIN to look up (e.g. B08N5WRWNW)."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"seller_name": {
"type": "string",
"description": "Exact buy-box seller name (case-insensitive)."
},
"since_weeks": {
"type": "integer",
"description": "Weeks of history (default 26, max 52)."
},
"last_seen_to": {
"type": "string"
},
"first_seen_to": {
"type": "string"
},
"max_days_seen": {
"type": "number"
},
"min_days_seen": {
"type": "number"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"last_seen_from": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD."
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number"
},
"max_buybox_avg_price": {
"type": "number"
},
"min_buybox_avg_price": {
"type": "number"
},
"seller_name_contains": {
"type": "string"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number",
"description": "Only sellers with at least this many observed buy-box days."
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| max_seller_count | number |
| min_seller_count | number | Only comparables with at least this many distinct sellers. |
| max_days_observed | number |
| min_days_observed | number |
| buybox_seller_contains | string |
| product_brand_contains | string |
| product_title_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"asin"
],
"properties": {
"asin": {
"type": "string",
"description": "Reference ASIN (e.g. B08N5WRWNW)."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"buybox_seller": {
"type": "string",
"description": "Exact buy-box seller name (case-insensitive)."
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number",
"description": "Only comparables with at least this many distinct sellers."
},
"max_days_observed": {
"type": "number"
},
"min_days_observed": {
"type": "number"
},
"buybox_seller_contains": {
"type": "string"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| max_seller_count |
| number |
| min_observations | number |
| min_seller_count | number | Keep only timeline weeks with at least this seller_count. |
| max_asins_touched | number |
| min_asins_touched | number |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
| max_seller_count_change_pct | number |
| min_seller_count_change_pct | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"trend_in": {
"type": "string",
"description": "Comma-separated trend labels to keep: CONCENTRATING, DECONCENTRATING, STABLE, INSUFFICIENT_DATA. If the brand's trend isn't in the list, an empty result is returned."
},
"since_weeks": {
"type": "integer",
"description": "Weeks of history to return (default 26, max 52)."
},
"week_start_to": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"week_start_from": {
"type": "string",
"description": "Keep only timeline weeks on/after this YYYY-MM-DD."
},
"max_observations": {
"type": "number"
},
"max_seller_count": {
"type": "number"
},
"min_observations": {
"type": "number"
},
"min_seller_count": {
"type": "number",
"description": "Keep only timeline weeks with at least this seller_count."
},
"max_asins_touched": {
"type": "number"
},
"min_asins_touched": {
"type": "number"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
},
"max_seller_count_change_pct": {
"type": "number"
},
"min_seller_count_change_pct": {
"type": "number"
}
}
}| string |
| Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| last_seen_from | string |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | YYYY-MM-DD (since_days already bounds the lower edge). |
| max_latest_price | number |
| max_seller_count | number |
| min_latest_price | number |
| min_seller_count | number |
| latest_buybox_seller | string | Exact most-recent buy-box seller (case-insensitive). |
| product_brand_contains | string |
| product_title_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
| latest_buybox_seller_contains | string |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"since_days": {
"type": "integer",
"description": "How far back to look (default 30, max 180)."
},
"last_seen_to": {
"type": "string"
},
"asin_contains": {
"type": "string"
},
"first_seen_to": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"last_seen_from": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD (since_days already bounds the lower edge)."
},
"max_latest_price": {
"type": "number"
},
"max_seller_count": {
"type": "number"
},
"min_latest_price": {
"type": "number"
},
"min_seller_count": {
"type": "number"
},
"latest_buybox_seller": {
"type": "string",
"description": "Exact most-recent buy-box seller (case-insensitive)."
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
},
"latest_buybox_seller_contains": {
"type": "string"
}
}
}| number |
| min_seller_count | number | Only similar brands with at least this many unique sellers (3m). |
| max_control_score | number |
| min_control_score | number |
| max_buybox_days_3m | number |
| min_buybox_days_3m | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "Reference brand name (case-insensitive)."
},
"limit": {
"type": "integer"
},
"max_avg_price": {
"type": "number"
},
"min_avg_price": {
"type": "number"
},
"brand_contains": {
"type": "string",
"description": "Only keep similar brands whose name contains this substring."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number",
"description": "Only similar brands with at least this many unique sellers (3m)."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_buybox_days_3m": {
"type": "number"
},
"min_buybox_days_3m": {
"type": "number"
}
}
}| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number"
},
"marketplace_id_in": {
"type": "string",
"description": "Comma-separated marketplace ids to keep: 1=Amazon UK, 2=Amazon US, 3=Walmart US."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| min_new_sellers |
| integer |
| Minimum new-seller count to surface (default 2). |
| max_control_score | number |
| min_control_score | number |
| max_total_sellers_3m | number |
| min_total_sellers_3m | number |
| max_seller_churn_30d_pct | number |
| min_seller_churn_30d_pct | number |
| max_catalog_churn_30d_pct | number |
| min_catalog_churn_30d_pct | number |
| max_newly_observed_sellers_in_window | number | Upper bound on new-seller count (min is min_new_sellers). |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"scope": {
"enum": [
"tracked",
"universe"
],
"type": "string",
"description": "tracked = only brands on the user's watchlist; universe = all brands. Default universe."
},
"category": {
"type": "string"
},
"window_days": {
"type": "integer",
"description": "Days back (default 30, max 90)."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"min_new_sellers": {
"type": "integer",
"description": "Minimum new-seller count to surface (default 2)."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_total_sellers_3m": {
"type": "number"
},
"min_total_sellers_3m": {
"type": "number"
},
"max_seller_churn_30d_pct": {
"type": "number"
},
"min_seller_churn_30d_pct": {
"type": "number"
},
"max_catalog_churn_30d_pct": {
"type": "number"
},
"min_catalog_churn_30d_pct": {
"type": "number"
},
"max_newly_observed_sellers_in_window": {
"type": "number",
"description": "Upper bound on new-seller count (min is min_new_sellers)."
}
}
}| number |
| max_shared_operators | number |
| min_shared_operators | number | Only related brands sharing at least this many operators. |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "The target brand to find network connections for."
},
"limit": {
"type": "integer"
},
"brand_contains": {
"type": "string",
"description": "Only keep related brands whose name contains this substring."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number"
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_shared_operators": {
"type": "number"
},
"min_shared_operators": {
"type": "number",
"description": "Only related brands sharing at least this many operators."
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| max_buybox_price | number |
| min_buybox_price | number |
| max_est_units_30d | number |
| min_est_units_30d | number |
| authorized_sellers | array | Optional. Your authorized sellers (else the saved list is used). |
| buybox_holder_contains | string |
| product_brand_contains | string |
| product_title_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
| max_est_revenue_at_stake_30d | number |
| min_est_revenue_at_stake_30d | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"brand": {
"type": "string",
"description": "The brand you own/manage."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"buybox_holder": {
"type": "string",
"description": "Exact current buy-box holder (case-insensitive)."
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"max_buybox_price": {
"type": "number"
},
"min_buybox_price": {
"type": "number"
},
"max_est_units_30d": {
"type": "number"
},
"min_est_units_30d": {
"type": "number"
},
"authorized_sellers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Your authorized sellers (else the saved list is used)."
},
"buybox_holder_contains": {
"type": "string"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
},
"max_est_revenue_at_stake_30d": {
"type": "number"
},
"min_est_revenue_at_stake_30d": {
"type": "number"
}
}
}| max_pct_amazon_pl |
| number |
| min_pct_amazon_pl | number |
| category_name_contains | string |
| max_amazon_expansion_net_90d | number |
| max_amz_retail_dominance_pct | number |
| min_amazon_expansion_net_90d | number |
| min_amz_retail_dominance_pct | number |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Max results (capped at 10). Default 10."
},
"category_name": {
"type": "string",
"description": "Exact category name (case-insensitive)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"max_brand_count": {
"type": "number"
},
"min_brand_count": {
"type": "number"
},
"velocity_tier_in": {
"type": "string",
"description": "Comma-separated velocity tiers to keep."
},
"max_pct_amazon_pl": {
"type": "number"
},
"min_pct_amazon_pl": {
"type": "number"
},
"category_name_contains": {
"type": "string"
},
"max_amazon_expansion_net_90d": {
"type": "number"
},
"max_amz_retail_dominance_pct": {
"type": "number"
},
"min_amazon_expansion_net_90d": {
"type": "number"
},
"min_amz_retail_dominance_pct": {
"type": "number"
}
}
}| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number |
| min_asin_count | number |
| max_seller_count | number |
| min_seller_count | number |
| first_observed_to | string |
| max_buybox_days_3m | number |
| min_buybox_days_3m | number |
| first_observed_from | string | YYYY-MM-DD lower bound on first-observed date. |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"since_days": {
"type": "integer",
"description": "How far back to look (default 30, max 180)."
},
"category_id": {
"type": "integer",
"description": "Root category ID."
},
"category_name": {
"type": "string",
"description": "Category name (fuzzy match if category_id not provided)."
},
"max_avg_price": {
"type": "number"
},
"min_avg_price": {
"type": "number"
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number"
},
"first_observed_to": {
"type": "string"
},
"max_buybox_days_3m": {
"type": "number"
},
"min_buybox_days_3m": {
"type": "number"
},
"first_observed_from": {
"type": "string",
"description": "YYYY-MM-DD lower bound on first-observed date."
}
}
}| min_prior_sellers |
| number |
| max_obs_growth_pct | number |
| max_recent_sellers | number |
| min_obs_growth_pct | number |
| min_recent_sellers | number |
| max_seller_growth_pct | number |
| min_seller_growth_pct | number |
| max_prior_observations | number |
| min_prior_observations | number |
| max_recent_observations | number |
| min_recent_observations | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"category_id": {
"type": "integer",
"description": "Root category ID."
},
"since_months": {
"type": "integer",
"description": "Months to compare (default 3, max 6). Compares latest month vs earliest."
},
"category_name": {
"type": "string",
"description": "Category name (fuzzy match if category_id not provided)."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_prior_sellers": {
"type": "number"
},
"min_prior_sellers": {
"type": "number"
},
"max_obs_growth_pct": {
"type": "number"
},
"max_recent_sellers": {
"type": "number"
},
"min_obs_growth_pct": {
"type": "number"
},
"min_recent_sellers": {
"type": "number"
},
"max_seller_growth_pct": {
"type": "number"
},
"min_seller_growth_pct": {
"type": "number"
},
"max_prior_observations": {
"type": "number"
},
"min_prior_observations": {
"type": "number"
},
"max_recent_observations": {
"type": "number"
},
"min_recent_observations": {
"type": "number"
}
}
}| min_avg_price |
| number |
| Minimum average price in USD. Omit for no floor. |
| brand_contains | string |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number |
| min_asin_count | number |
| min_buybox_days | integer | Minimum observed buybox days in last 3 months (default 30). |
| max_velocity_90d | number |
| min_velocity_90d | number |
| max_control_score | number |
| min_control_score | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"category_id": {
"type": "integer",
"description": "Root category ID to search within."
},
"max_sellers": {
"type": "integer",
"description": "Maximum unique sellers (default 20)."
},
"min_sellers": {
"type": "integer",
"description": "Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand."
},
"category_name": {
"type": "string",
"description": "Category name (fuzzy match if category_id not provided)."
},
"max_avg_price": {
"type": "number",
"description": "Maximum average price in USD. Omit for no cap."
},
"min_avg_price": {
"type": "number",
"description": "Minimum average price in USD. Omit for no floor."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"min_buybox_days": {
"type": "integer",
"description": "Minimum observed buybox days in last 3 months (default 30)."
},
"max_velocity_90d": {
"type": "number"
},
"min_velocity_90d": {
"type": "number"
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
}
}
}| number |
| min_winner_diversity | number |
| seller_name_contains | string |
| max_unique_sellers_3m | number |
| min_unique_sellers_3m | number |
| max_seller_churn_30d_pct | number |
| min_seller_churn_30d_pct | number |
| max_catalog_churn_30d_pct | number |
| max_pct_asins_gated_to_3p | number |
| min_catalog_churn_30d_pct | number |
| min_pct_asins_gated_to_3p | number |
| max_bought_past_month_total | number |
| min_bought_past_month_total | number |
| max_amz_retail_dominance_pct | number |
| min_amz_retail_dominance_pct | number |
| max_total_observed_buybox_days | number |
| min_total_observed_buybox_days | number |
| max_brand_velocity_90d_units_day | number |
| min_brand_velocity_90d_units_day | number |
| dominant_category_velocity_tier_in | string | Comma-separated velocity tiers to keep in the brand list. |
| max_seller_churn_30d_delta_vs_cat_pp | number |
| min_seller_churn_30d_delta_vs_cat_pp | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string"
},
"seller_name": {
"type": "string",
"description": "Exact seller name in the sellers list (case-insensitive)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_brand_count": {
"type": "number"
},
"min_brand_count": {
"type": "number"
},
"category_root_id": {
"type": "integer"
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_winner_diversity": {
"type": "number"
},
"min_winner_diversity": {
"type": "number"
},
"seller_name_contains": {
"type": "string"
},
"max_unique_sellers_3m": {
"type": "number"
},
"min_unique_sellers_3m": {
"type": "number"
},
"max_seller_churn_30d_pct": {
"type": "number"
},
"min_seller_churn_30d_pct": {
"type": "number"
},
"max_catalog_churn_30d_pct": {
"type": "number"
},
"max_pct_asins_gated_to_3p": {
"type": "number"
},
"min_catalog_churn_30d_pct": {
"type": "number"
},
"min_pct_asins_gated_to_3p": {
"type": "number"
},
"max_bought_past_month_total": {
"type": "number"
},
"min_bought_past_month_total": {
"type": "number"
},
"max_amz_retail_dominance_pct": {
"type": "number"
},
"min_amz_retail_dominance_pct": {
"type": "number"
},
"max_total_observed_buybox_days": {
"type": "number"
},
"min_total_observed_buybox_days": {
"type": "number"
},
"max_brand_velocity_90d_units_day": {
"type": "number"
},
"min_brand_velocity_90d_units_day": {
"type": "number"
},
"dominant_category_velocity_tier_in": {
"type": "string",
"description": "Comma-separated velocity tiers to keep in the brand list."
},
"max_seller_churn_30d_delta_vs_cat_pp": {
"type": "number"
},
"min_seller_churn_30d_delta_vs_cat_pp": {
"type": "number"
}
}
}| min_margin |
| number |
| min_rating | number |
| max_velocity | number |
| min_velocity | number |
| asin_contains | string |
| product_brand | string | Exact product brand (case-insensitive) on top_asins. |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep on top_asins. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_composite_score | number |
| min_composite_score | number |
| max_number_of_ratings | number |
| min_number_of_ratings | number |
| product_brand_contains | string |
| product_title_contains | string |
| distribution_verdict_in | string | Comma-separated distribution verdicts to keep, e.g. 'DOMINANT SELLER', 'OPEN DISTRIBUTION', 'HIGH BRAND HEAT'. If the brand's verdict isn't in the list, an empty result is returned. |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"asin": {
"type": "string",
"description": "Keep only this ASIN in top_asins."
},
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"max_gating": {
"type": "number"
},
"max_margin": {
"type": "number"
},
"max_rating": {
"type": "number"
},
"min_gating": {
"type": "number"
},
"min_margin": {
"type": "number"
},
"min_rating": {
"type": "number"
},
"max_velocity": {
"type": "number"
},
"min_velocity": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive) on top_asins."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep on top_asins."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_composite_score": {
"type": "number"
},
"min_composite_score": {
"type": "number"
},
"max_number_of_ratings": {
"type": "number"
},
"min_number_of_ratings": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"distribution_verdict_in": {
"type": "string",
"description": "Comma-separated distribution verdicts to keep, e.g. 'DOMINANT SELLER', 'OPEN DISTRIBUTION', 'HIGH BRAND HEAT'. If the brand's verdict isn't in the list, an empty result is returned."
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| FBA share threshold (0-100, percentage). |
| max_control_score | number |
| min_control_score | number |
| min_sourcing_score | integer | Optional — minimum control_score (heat) filter. |
| max_asins_touched_3m | number |
| max_winner_diversity | number |
| min_asins_touched_3m | number |
| min_winner_diversity | number |
| max_unique_sellers_3m | number |
| min_unique_sellers_3m | number |
| max_amz_retail_dominance_pct | number |
| min_amz_retail_dominance_pct | number |
{
"type": "object",
"required": [
"marketplace_id",
"fba_share_op",
"fba_share_value"
],
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"sort_by": {
"enum": [
"control_score",
"unique_sellers_3m",
"brand_bought_past_month_30d"
],
"type": "string",
"description": "Sort column (default control_score)."
},
"fba_share_op": {
"enum": [
"<",
"<=",
">",
">="
],
"type": "string",
"description": "Comparison operator for FBA share threshold."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"fba_share_value": {
"type": "number",
"description": "FBA share threshold (0-100, percentage)."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"min_sourcing_score": {
"type": "integer",
"description": "Optional — minimum control_score (heat) filter."
},
"max_asins_touched_3m": {
"type": "number"
},
"max_winner_diversity": {
"type": "number"
},
"min_asins_touched_3m": {
"type": "number"
},
"min_winner_diversity": {
"type": "number"
},
"max_unique_sellers_3m": {
"type": "number"
},
"min_unique_sellers_3m": {
"type": "number"
},
"max_amz_retail_dominance_pct": {
"type": "number"
},
"min_amz_retail_dominance_pct": {
"type": "number"
}
}
}| min_avg_rating | number |
| fba_share_value* | number | FBA share threshold (0-100, percentage). |
| max_asins_touched | number |
| min_asins_touched | number |
| max_brands_touched | number |
| min_brands_touched | number |
| max_avg_rating_count | number |
| max_sold_30d_revenue | number |
| min_avg_rating_count | number |
| min_sold_30d_revenue | number |
| seller_name_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"marketplace_id",
"fba_share_op",
"fba_share_value"
],
"properties": {
"brand": {
"type": "string",
"description": "Optional — filter to operators selling this brand."
},
"limit": {
"type": "integer"
},
"sort_by": {
"enum": [
"buybox_days",
"brands_touched",
"asins_touched"
],
"type": "string",
"description": "Sort column (default buybox_days)."
},
"seller_name": {
"type": "string",
"description": "Exact seller/operator name (case-insensitive)."
},
"fba_share_op": {
"enum": [
"<",
"<=",
">",
">="
],
"type": "string",
"description": "Comparison operator for FBA share threshold."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_avg_rating": {
"type": "number"
},
"min_avg_rating": {
"type": "number"
},
"fba_share_value": {
"type": "number",
"description": "FBA share threshold (0-100, percentage)."
},
"max_asins_touched": {
"type": "number"
},
"min_asins_touched": {
"type": "number"
},
"max_brands_touched": {
"type": "number"
},
"min_brands_touched": {
"type": "number"
},
"max_avg_rating_count": {
"type": "number"
},
"max_sold_30d_revenue": {
"type": "number"
},
"min_avg_rating_count": {
"type": "number"
},
"min_sold_30d_revenue": {
"type": "number"
},
"seller_name_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| max_seller_churn_30d_pct | number |
| min_seller_churn_30d_pct | number |
| max_brand_velocity_90d_units_day | number |
| min_brand_velocity_90d_units_day | number |
| dominant_category_velocity_tier_in | string | Comma-separated velocity tiers to keep. |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer",
"description": "Max results (capped at 10). Default 10."
},
"scope": {
"enum": [
"tracked",
"universe"
],
"type": "string",
"description": "tracked = only brands on the user's watchlist; universe = all brands. Default universe."
},
"category": {
"type": "string",
"description": "Category root name to filter (optional)."
},
"max_delta_pp": {
"type": "number",
"description": "Max delta vs category in percentage points. Omit for no ceiling."
},
"min_delta_pp": {
"type": "number",
"description": "Min delta vs category in percentage points. Default 5."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_seller_churn_30d_pct": {
"type": "number"
},
"min_seller_churn_30d_pct": {
"type": "number"
},
"max_brand_velocity_90d_units_day": {
"type": "number"
},
"min_brand_velocity_90d_units_day": {
"type": "number"
},
"dominant_category_velocity_tier_in": {
"type": "string",
"description": "Comma-separated velocity tiers to keep."
}
}
}| max_control_score | number |
| min_control_score | number |
| max_new_seller_count | number |
| max_old_seller_count | number |
| min_new_seller_count | number |
| min_old_seller_count | number |
| max_seller_growth_pct | number |
| min_seller_growth_pct | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"since_weeks": {
"type": "integer",
"description": "Window to compare (default 12, max 26). Compares first half vs second half."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"min_buybox_days": {
"type": "integer",
"description": "Minimum observed buybox days to filter out inactive brands (default 30)."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_new_seller_count": {
"type": "number"
},
"max_old_seller_count": {
"type": "number"
},
"min_new_seller_count": {
"type": "number"
},
"min_old_seller_count": {
"type": "number"
},
"max_seller_growth_pct": {
"type": "number"
},
"min_seller_growth_pct": {
"type": "number"
}
}
}| max_total_asins |
| number |
| min_total_asins | number |
| earliest_seen_to | string |
| earliest_seen_from | string | YYYY-MM-DD lower bound on earliest-seen date. |
| max_avg_rating_count | number |
| min_avg_rating_count | number |
| seller_name_contains | string |
| max_operator_fba_share_pct | number |
| min_operator_fba_share_pct | number |
| max_total_observed_buybox_days | number |
| min_total_observed_buybox_days | number |
{
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"min_brands": {
"type": "integer",
"description": "Minimum brands to filter out trivial sellers (default 5)."
},
"since_days": {
"type": "integer",
"description": "How far back to look (default 30, max 180)."
},
"seller_name": {
"type": "string",
"description": "Exact seller name (case-insensitive)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_avg_rating": {
"type": "number"
},
"min_avg_rating": {
"type": "number"
},
"max_total_asins": {
"type": "number"
},
"min_total_asins": {
"type": "number"
},
"earliest_seen_to": {
"type": "string"
},
"earliest_seen_from": {
"type": "string",
"description": "YYYY-MM-DD lower bound on earliest-seen date."
},
"max_avg_rating_count": {
"type": "number"
},
"min_avg_rating_count": {
"type": "number"
},
"seller_name_contains": {
"type": "string"
},
"max_operator_fba_share_pct": {
"type": "number"
},
"min_operator_fba_share_pct": {
"type": "number"
},
"max_total_observed_buybox_days": {
"type": "number"
},
"min_total_observed_buybox_days": {
"type": "number"
}
}
}| min_price | number | Only web sources priced >= this. |
| currency_in | string | Comma-separated currencies to keep (e.g. USD). |
| marketplace_id | integer | Marketplace (2 = Amazon US). Default 2. |
| source_class_in | string | Comma-separated source classes to keep (retailer/marketplace/wholesale). |
| source_contains | string |
| max_spread_vs_buybox | number |
| min_spread_vs_buybox | number |
| max_dropship_net_margin | number |
| min_dropship_net_margin | number |
{
"type": "object",
"properties": {
"upc": {
"type": "string",
"description": "UPC code."
},
"asin": {
"type": "string",
"description": "Amazon ASIN (the strongest anchor)."
},
"gtin": {
"type": "string",
"description": "GTIN code."
},
"mode": {
"enum": [
"price_compare",
"cheaper",
"dropship",
"supplier"
],
"type": "string",
"description": "price_compare (default) | cheaper | dropship | supplier."
},
"brand": {
"type": "string",
"description": "Brand (with title)."
},
"title": {
"type": "string",
"description": "Product title (use with brand to resolve the ASIN)."
},
"source": {
"type": "string",
"description": "Exact merchant/source name (case-insensitive)."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number",
"description": "Only web sources priced >= this."
},
"currency_in": {
"type": "string",
"description": "Comma-separated currencies to keep (e.g. USD)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace (2 = Amazon US). Default 2."
},
"source_class_in": {
"type": "string",
"description": "Comma-separated source classes to keep (retailer/marketplace/wholesale)."
},
"source_contains": {
"type": "string"
},
"max_spread_vs_buybox": {
"type": "number"
},
"min_spread_vs_buybox": {
"type": "number"
},
"max_dropship_net_margin": {
"type": "number"
},
"min_dropship_net_margin": {
"type": "number"
}
}
}| dominant_seller | string | Exact dominant-seller name (case-insensitive). |
| min_buybox_days | integer | Minimum observed buybox days in last 3 months (default 30). |
| max_control_score | number |
| min_control_score | number |
| dominant_seller_contains | string |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"min_asins": {
"type": "integer",
"description": "Minimum ASINs to filter out trivially small brands (default 10)."
},
"category_id": {
"type": "integer",
"description": "Filter to a specific root category. Omit for all."
},
"max_avg_price": {
"type": "number",
"description": "Maximum average price in USD. Omit for no cap."
},
"min_avg_price": {
"type": "number",
"description": "Minimum average price in USD. Omit for no floor."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"dominant_seller": {
"type": "string",
"description": "Exact dominant-seller name (case-insensitive)."
},
"min_buybox_days": {
"type": "integer",
"description": "Minimum observed buybox days in last 3 months (default 30)."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"dominant_seller_contains": {
"type": "string"
}
}
}| Maximum average buybox price in USD. Omit for no price filter. |
| min_avg_price | number | Minimum average buybox price in USD. Omit for no price filter. |
| brand_contains | string |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_asin_count | number |
| min_asin_count | number |
| min_buybox_days | integer | Minimum observed buybox days in last 3 months (sales floor). Default 30. |
| include_catchall | boolean | Include reseller umbrella brands (PATIKIL, Uxcell, etc.). Default false. |
| max_velocity_90d | number |
| min_velocity_90d | number |
| max_control_score | number |
| min_control_score | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer"
},
"seed_brand": {
"type": "string",
"description": "Reference brand to derive category from. Results stay in the same root category."
},
"category_id": {
"type": "integer",
"description": "Filter to a specific root category ID. Overrides seed_brand if both given."
},
"max_sellers": {
"type": "integer",
"description": "Maximum unique sellers (competition ceiling). Default 20."
},
"min_sellers": {
"type": "integer",
"description": "Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand (the default 10–20 window: under-competed but real)."
},
"max_avg_price": {
"type": "number",
"description": "Maximum average buybox price in USD. Omit for no price filter."
},
"min_avg_price": {
"type": "number",
"description": "Minimum average buybox price in USD. Omit for no price filter."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"min_buybox_days": {
"type": "integer",
"description": "Minimum observed buybox days in last 3 months (sales floor). Default 30."
},
"include_catchall": {
"type": "boolean",
"description": "Include reseller umbrella brands (PATIKIL, Uxcell, etc.). Default false."
},
"max_velocity_90d": {
"type": "number"
},
"min_velocity_90d": {
"type": "number"
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
}
}
}| 'low' (stricter Amazon-presence ceiling) or 'balanced' (default). |
| category_name | string | Department/category to find niches within (e.g. 'electronics', 'home & kitchen', 'pet supplies'). Omit for niches across all departments. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| niche_contains | string |
| unhappy_shoppers | boolean | Bias toward niches where shoppers are underwhelmed (a credible dissatisfaction gap = a PL opening). Default false. |
| pl_winnability_in | string | Comma-separated verdicts to keep (Strong/Moderate/Weak). |
| max_competing_brands | number |
| max_seller_diversity | number |
| min_competing_brands | number |
| min_seller_diversity | number |
| max_avg_product_rating | number |
| max_monthly_demand_usd | number |
| min_avg_product_rating | number |
| min_monthly_demand_usd | number |
| max_amazon_retail_share_pct | number |
| min_amazon_retail_share_pct | number |
{
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"niche": {
"type": "string",
"description": "Exact niche (subcategory) name, case-insensitive."
},
"price_max": {
"type": "number",
"description": "Maximum average price in the marketplace's own currency. Omit for that marketplace's PL margin band (Amazon US: 70)."
},
"price_min": {
"type": "number",
"description": "Minimum average price in the marketplace's own currency. Omit for that marketplace's PL margin band (Amazon US: 20)."
},
"category_id": {
"type": "integer",
"description": "Root category id to scope to (overrides category_name)."
},
"competition": {
"type": "string",
"description": "'low' (stricter Amazon-presence ceiling) or 'balanced' (default)."
},
"category_name": {
"type": "string",
"description": "Department/category to find niches within (e.g. 'electronics', 'home & kitchen', 'pet supplies'). Omit for niches across all departments."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"niche_contains": {
"type": "string"
},
"unhappy_shoppers": {
"type": "boolean",
"description": "Bias toward niches where shoppers are underwhelmed (a credible dissatisfaction gap = a PL opening). Default false."
},
"pl_winnability_in": {
"type": "string",
"description": "Comma-separated verdicts to keep (Strong/Moderate/Weak)."
},
"max_competing_brands": {
"type": "number"
},
"max_seller_diversity": {
"type": "number"
},
"min_competing_brands": {
"type": "number"
},
"min_seller_diversity": {
"type": "number"
},
"max_avg_product_rating": {
"type": "number"
},
"max_monthly_demand_usd": {
"type": "number"
},
"min_avg_product_rating": {
"type": "number"
},
"min_monthly_demand_usd": {
"type": "number"
},
"max_amazon_retail_share_pct": {
"type": "number"
},
"min_amazon_retail_share_pct": {
"type": "number"
}
}
}{
"type": "object",
"properties": {
"zip": {
"type": "string",
"description": "US 5-digit ZIP: the offers as a shopper at that ZIP sees them (Amazon US only; first page of offers)."
},
"asin": {
"type": "string",
"description": "10-character Amazon ASIN. Provide asin or barcode."
},
"barcode": {
"type": "string",
"description": "UPC / EAN / GTIN / ISBN-13 instead of an ASIN."
},
"include_used": {
"type": "boolean",
"default": false,
"description": "Also list used, refurbished and collectible offers."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
}
}
}| max_map_floor_usd |
| number |
| max_violation_pct | number | Maximum violation percentage below MAP. |
| min_map_floor_usd | number |
| min_violation_pct | number | Minimum violation percentage below MAP (default 0, meaning any violation). |
| max_observed_price_usd | number |
| min_observed_price_usd | number |
| product_title_contains | string |
| retailer_name_contains | string |
| retailer_domain_contains | string |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Filter to a specific brand. Omit for all workspace brands."
},
"limit": {
"type": "integer"
},
"last_seen_to": {
"type": "string"
},
"first_seen_to": {
"type": "string"
},
"retailer_name": {
"type": "string",
"description": "Exact retailer name (case-insensitive)."
},
"brand_contains": {
"type": "string",
"description": "Substring match on brand (use `brand` for an exact match)."
},
"last_seen_from": {
"type": "string"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD."
},
"retailer_domain": {
"type": "string",
"description": "Exact retailer domain (case-insensitive)."
},
"max_map_floor_usd": {
"type": "number"
},
"max_violation_pct": {
"type": "number",
"description": "Maximum violation percentage below MAP."
},
"min_map_floor_usd": {
"type": "number"
},
"min_violation_pct": {
"type": "number",
"description": "Minimum violation percentage below MAP (default 0, meaning any violation)."
},
"max_observed_price_usd": {
"type": "number"
},
"min_observed_price_usd": {
"type": "number"
},
"product_title_contains": {
"type": "string"
},
"retailer_name_contains": {
"type": "string"
},
"retailer_domain_contains": {
"type": "string"
}
}
}| category_id |
| integer |
| top_brands: root category id to narrow to. |
| marketplace_id | integer | 1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR. |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"brand_movers",
"seller_movers",
"top_brands",
"top_sellers",
"top_categories"
],
"type": "string"
},
"page": {
"type": "integer",
"default": 1
},
"sort": {
"type": "string",
"description": "top_*: the ranking field (see description)."
},
"window": {
"enum": [
30,
90
],
"type": "integer",
"default": 30,
"description": "movers: comparison window in days."
},
"direction": {
"enum": [
"up",
"down"
],
"type": "string",
"default": "up",
"description": "movers: gaining (up) or losing (down)."
},
"parent_id": {
"type": "integer",
"description": "top_categories: list this category's children."
},
"category_id": {
"type": "integer",
"description": "top_brands: root category id to narrow to."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1=UK 2=US 4=CA 5=AU 6=DE 7=JP 8=IT 9=FR 10=ES 11=MX 12=BR."
}
}
}| List of seller/operator names to look up. |
| max_competitor_count | number |
| min_competitor_count | number |
| max_operator_fba_share_pct | number |
| min_operator_fba_share_pct | number |
| max_observed_buybox_days_3m | number |
| min_observed_buybox_days_3m | number |
{
"type": "object",
"required": [
"operator_names"
],
"properties": {
"sort": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort by competitor count: 'asc' (least competition first, default) or 'desc'."
},
"brand": {
"type": "string",
"description": "Exact brand (case-insensitive)."
},
"limit": {
"type": "integer"
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"operator_names": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of seller/operator names to look up."
},
"max_competitor_count": {
"type": "number"
},
"min_competitor_count": {
"type": "number"
},
"max_operator_fba_share_pct": {
"type": "number"
},
"min_operator_fba_share_pct": {
"type": "number"
},
"max_observed_buybox_days_3m": {
"type": "number"
},
"min_observed_buybox_days_3m": {
"type": "number"
}
}
}| fulfillment_in | string | Comma-separated operator fulfillment to keep (FBA, FBM). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| min_est_revenue_30d | number | Only ASINs with estimated 30-day listing revenue >= this. |
| max_buybox_share_pct | number | Only ASINs where the operator holds LESS than this share of the buy-box (0-1; default 0.75 — i.e. it's not dominating). |
| exclude_amazon_in_box | boolean | Drop ASINs where Amazon holds the box (you can't win those). |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"sort": {
"enum": [
"revenue_at_risk",
"price_gap_pct",
"buybox_share",
"listing_revenue"
],
"type": "string",
"description": "Sort the leaks: revenue_at_risk (default), price_gap_pct (biggest recoverable gap), buybox_share (lowest first), or listing_revenue."
},
"limit": {
"type": "integer",
"description": "Leaks to return (default 25, max 100). This tool pages."
},
"min_price": {
"type": "number",
"description": "Only ASINs whose listing price >= this (skip pennies)."
},
"situation_in": {
"type": "string",
"description": "Comma-separated situations to keep (price_gap, tied_price, amazon_in_box, reseller_swarm)."
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated operator fulfillment to keep (FBA, FBM)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"min_est_revenue_30d": {
"type": "number",
"description": "Only ASINs with estimated 30-day listing revenue >= this."
},
"max_buybox_share_pct": {
"type": "number",
"description": "Only ASINs where the operator holds LESS than this share of the buy-box (0-1; default 0.75 — i.e. it's not dominating)."
},
"exclude_amazon_in_box": {
"type": "boolean",
"description": "Drop ASINs where Amazon holds the box (you can't win those)."
}
}
}| category_name_contains |
| string |
| max_total_observed_buybox_days | number |
| min_total_observed_buybox_days | number |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"limit": {
"type": "integer"
},
"category_name": {
"type": "string",
"description": "Exact category name (case-insensitive)."
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_brand_count": {
"type": "number"
},
"max_total_asins": {
"type": "number"
},
"min_brand_count": {
"type": "number"
},
"min_total_asins": {
"type": "number"
},
"category_name_contains": {
"type": "string"
},
"max_total_observed_buybox_days": {
"type": "number"
},
"min_total_observed_buybox_days": {
"type": "number"
}
}
}| string |
| Second operator/seller name. |
| contested_only | boolean | If true, skip the whitespace sections (only the head-to-head contested list). |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| whitespace_for | string | Which side's whitespace to compute (default both). |
| include_whitespace | boolean | Include each side's whitespace ASINs (default true). |
| min_est_revenue_30d | number | Only contested ASINs with estimated 30-day listing revenue >= this. |
{
"type": "object",
"required": [
"operator_a",
"operator_b"
],
"properties": {
"sort": {
"enum": [
"revenue_at_risk",
"price_gap",
"share_gap"
],
"type": "string",
"description": "Sort the contested list: revenue_at_risk (operator_a's 30d revenue at risk, default), price_gap (abs A-vs-B price gap), or share_gap (abs buy-box share gap)."
},
"brand": {
"type": "string",
"description": "Optional — scope the comparison to a single brand's ASINs (catalog sizes, contested, and whitespace are all limited to that brand). Omit for all brands."
},
"limit": {
"type": "integer",
"description": "Contested ASINs to return (default 25, max 100). This tool pages."
},
"operator_a": {
"type": "string",
"description": "First operator/seller name (the focal seller — revenue-at-risk + situation are from A's view)."
},
"operator_b": {
"type": "string",
"description": "Second operator/seller name."
},
"contested_only": {
"type": "boolean",
"description": "If true, skip the whitespace sections (only the head-to-head contested list)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"whitespace_for": {
"enum": [
"a",
"b",
"both"
],
"type": "string",
"description": "Which side's whitespace to compute (default both)."
},
"include_whitespace": {
"type": "boolean",
"description": "Include each side's whitespace ASINs (default true)."
},
"min_est_revenue_30d": {
"type": "number",
"description": "Only contested ASINs with estimated 30-day listing revenue >= this."
}
}
}| min_share_pct |
| number |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| operator_contains | string |
| max_listings_controlled | number |
| min_listings_controlled | number |
{
"type": "object",
"properties": {
"asins": {
"type": "array",
"items": {
"type": "string"
},
"description": "ASIN set to analyze."
},
"brand": {
"type": "string",
"description": "Or a brand whose catalog to analyze."
},
"limit": {
"type": "integer"
},
"max_hhi": {
"type": "number"
},
"min_hhi": {
"type": "number",
"description": "Only return the analysis if its HHI >= this (else empty top_operators)."
},
"operator": {
"type": "string",
"description": "Keep only this operator (exact, case-insensitive) in top_operators."
},
"max_share_pct": {
"type": "number"
},
"min_share_pct": {
"type": "number"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"operator_contains": {
"type": "string"
},
"max_listings_controlled": {
"type": "number"
},
"min_listings_controlled": {
"type": "number"
}
}
}| string |
| last_seen_week_from | string | YYYY-MM-DD lower bound on last_seen_week. |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"brand": {
"type": "string",
"description": "Exact brand (case-insensitive)."
},
"limit": {
"type": "integer"
},
"since_days": {
"type": "integer",
"description": "Window to compare (default 30, max 180). Brands present before but absent in the last since_days."
},
"first_seen_to": {
"type": "string"
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string"
},
"last_seen_week_to": {
"type": "string"
},
"last_seen_week_from": {
"type": "string",
"description": "YYYY-MM-DD lower bound on last_seen_week."
}
}
}{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"brand": {
"type": "string",
"description": "Exact brand (case-insensitive)."
},
"limit": {
"type": "integer"
},
"since_days": {
"type": "integer",
"description": "How far back to look for new brands (default 30, max 180)."
},
"first_seen_to": {
"type": "string"
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD lower bound on first_seen."
}
}
}| integer |
| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| first_observed_to | string |
| operator_contains | string |
| first_observed_from | string | YYYY-MM-DD lower bound on first_observed. |
| max_total_days_seen | number |
| min_total_days_seen | number |
| max_n_asins_on_brand | number |
| min_n_asins_on_brand | number |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "The brand to watch."
},
"limit": {
"type": "integer"
},
"operator": {
"type": "string",
"description": "Exact operator/seller name (case-insensitive)."
},
"since_days": {
"type": "integer",
"description": "Window in days (default 30, max 180)."
},
"still_active": {
"type": "boolean",
"description": "Keep only operators last seen within 7 days (true) or not (false)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"first_observed_to": {
"type": "string"
},
"operator_contains": {
"type": "string"
},
"first_observed_from": {
"type": "string",
"description": "YYYY-MM-DD lower bound on first_observed."
},
"max_total_days_seen": {
"type": "number"
},
"min_total_days_seen": {
"type": "number"
},
"max_n_asins_on_brand": {
"type": "number"
},
"min_n_asins_on_brand": {
"type": "number"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| string |
| Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| max_est_units_30d | number |
| min_est_units_30d | number |
| max_sourcing_score | number |
| min_sourcing_score | number | Only candidates with sourcing score >= this. |
| resold_by_contains | string | Keep candidates resold by a seller whose name contains this. |
| max_buybox_avg_price | number |
| min_buybox_avg_price | number |
| product_brand_contains | string |
| product_title_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "An ASIN whose operators to expand from."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"operator_name": {
"type": "string",
"description": "Or a seller/operator name directly."
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"max_est_units_30d": {
"type": "number"
},
"min_est_units_30d": {
"type": "number"
},
"max_sourcing_score": {
"type": "number"
},
"min_sourcing_score": {
"type": "number",
"description": "Only candidates with sourcing score >= this."
},
"resold_by_contains": {
"type": "string",
"description": "Keep candidates resold by a seller whose name contains this."
},
"max_buybox_avg_price": {
"type": "number"
},
"min_buybox_avg_price": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| last_seen_to |
| string |
| asin_contains | string |
| first_seen_to | string |
| max_days_seen | number |
| min_days_seen | number |
| operator_name* | string | Seller/operator name. |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| last_seen_from | string |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | YYYY-MM-DD. |
| max_est_units_30d | number |
| min_est_units_30d | number |
| max_est_revenue_30d | number |
| min_est_revenue_30d | number |
| max_buybox_avg_price | number |
| max_buybox_share_pct | number |
| min_buybox_avg_price | number |
| min_buybox_share_pct | number | Only ASINs where the operator's buybox share >= this. |
| product_brand_contains | string |
| product_title_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"sort": {
"enum": [
"est_sales",
"buybox_days",
"price",
"days_seen"
],
"type": "string",
"description": "Sort order: est_sales (estimated 30-day revenue, default), buybox_days (observed buybox days won), price, or days_seen."
},
"limit": {
"type": "integer",
"description": "Number of ASINs to return (default 10, max 50)."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"est_basis_in": {
"type": "string",
"description": "Comma-separated sales-estimate sources to keep."
},
"last_seen_to": {
"type": "string"
},
"asin_contains": {
"type": "string"
},
"first_seen_to": {
"type": "string"
},
"max_days_seen": {
"type": "number"
},
"min_days_seen": {
"type": "number"
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"last_seen_from": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD."
},
"max_est_units_30d": {
"type": "number"
},
"min_est_units_30d": {
"type": "number"
},
"max_est_revenue_30d": {
"type": "number"
},
"min_est_revenue_30d": {
"type": "number"
},
"max_buybox_avg_price": {
"type": "number"
},
"max_buybox_share_pct": {
"type": "number"
},
"min_buybox_avg_price": {
"type": "number"
},
"min_buybox_share_pct": {
"type": "number",
"description": "Only ASINs where the operator's buybox share >= this."
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| max_asin_count | number |
| min_asin_count | number |
| max_est_units_30d | number |
| min_est_units_30d | number |
| max_est_revenue_30d | number |
| min_est_revenue_30d | number |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"operator_name"
],
"properties": {
"sort": {
"enum": [
"est_sales",
"est_units",
"buybox_days",
"asin_count"
],
"type": "string",
"description": "Sort order: est_sales (estimated 30-day revenue, default), est_units, buybox_days (observed buybox days), or asin_count."
},
"brand": {
"type": "string",
"description": "Exact brand (case-insensitive)."
},
"limit": {
"type": "integer"
},
"operator_name": {
"type": "string",
"description": "Seller/operator name."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_asin_count": {
"type": "number"
},
"min_asin_count": {
"type": "number"
},
"max_est_units_30d": {
"type": "number"
},
"min_est_units_30d": {
"type": "number"
},
"max_est_revenue_30d": {
"type": "number"
},
"min_est_revenue_30d": {
"type": "number"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| boolean |
| Attach the listing content: description, bullets, featured reviews. |
| include_history | boolean | Attach the long history series (offer history per seller, daily buy-box price, BSR history). |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "10-character Amazon ASIN. Provide asin or barcode."
},
"barcode": {
"type": "string",
"description": "UPC-12 / EAN-13 / GTIN-14 / ISBN-13 instead of an ASIN. Resolved through observed listings, then Amazon's own search."
},
"refresh": {
"type": "boolean",
"default": false,
"description": "Read the live Amazon page now instead of the stored snapshot."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"include_content": {
"type": "boolean",
"default": false,
"description": "Attach the listing content: description, bullets, featured reviews."
},
"include_history": {
"type": "boolean",
"default": false,
"description": "Attach the long history series (offer history per seller, daily buy-box price, BSR history)."
}
}
}| Comma-separated severities to keep (high/medium/low). |
| buybox_seller | string | Exact offending buy-box seller (case-insensitive). |
| event_date_to | string |
| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| event_date_from | string | YYYY-MM-DD. |
| max_listed_price | number |
| min_listed_price | number |
| buybox_seller_contains | string |
| product_brand_contains | string |
| product_title_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string"
},
"days": {
"type": "integer",
"description": "Lookback window for MAP events. Default 30."
},
"brand": {
"type": "string"
},
"kind_in": {
"type": "string",
"description": "Comma-separated flagged-event kinds to keep (e.g. map_violations,amazon_dominated)."
},
"max_count": {
"type": "number"
},
"max_price": {
"type": "number"
},
"min_count": {
"type": "number"
},
"min_price": {
"type": "number"
},
"severity_in": {
"type": "string",
"description": "Comma-separated severities to keep (high/medium/low)."
},
"buybox_seller": {
"type": "string",
"description": "Exact offending buy-box seller (case-insensitive)."
},
"event_date_to": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"event_date_from": {
"type": "string",
"description": "YYYY-MM-DD."
},
"max_listed_price": {
"type": "number"
},
"min_listed_price": {
"type": "number"
},
"buybox_seller_contains": {
"type": "string"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| max_rating_count | number |
| min_rating_count | number |
| max_demand_units_30d | number |
| min_demand_units_30d | number |
| max_demand_revenue_30d | number |
| min_demand_revenue_30d | number |
| product_brand_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "string",
"description": "Free-text product keywords, e.g. 'stainless steel water bottle'."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"max_rating": {
"type": "number"
},
"min_rating": {
"type": "number"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"max_rating_count": {
"type": "number"
},
"min_rating_count": {
"type": "number"
},
"max_demand_units_30d": {
"type": "number"
},
"min_demand_units_30d": {
"type": "number"
},
"max_demand_revenue_30d": {
"type": "number"
},
"min_demand_revenue_30d": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only. |
| include_history | boolean | Append history: rating change points + storefront-size points (oldest first, UTC). |
{
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "Amazon seller id: 'A' + 8-24 letters/digits. Give this OR operator_name."
},
"operator_name": {
"type": "string",
"description": "The seller / operator display name as the operator_* tools return it (resolved to a seller id on the chosen marketplace; the id wins when both are given)."
},
"history_points": {
"type": "integer",
"default": 50,
"description": "include_history=true: the latest N change points per series (1-200)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. Amazon only."
},
"include_history": {
"type": "boolean",
"default": false,
"description": "Append history: rating change points + storefront-size points (oldest first, UTC)."
}
}
}| max_price | number | Optional price ceiling. |
| min_price | number | Optional price floor. |
| attributes | array | Tokens that MUST appear in the product title, e.g. ['3.5mm'] or ['5090']. |
| exclude_terms | array | Words indicating the WRONG product, e.g. ['ethernet','usb'] for an audio patch cable. |
| category_hints | array | Category words the right product lives in, e.g. ['instrument cables','audio cables']. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
{
"type": "object",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"best",
"cheapest",
"value"
],
"type": "string",
"default": "best",
"description": "'best' = rating-first per class/tier (default); 'cheapest' = lowest-price-first; 'value' = best quality-per-dollar ('best buy'/'optimal'). Auto-detected from the query."
},
"query": {
"type": "string",
"description": "What to buy, e.g. 'best electric toothbrush for sensitive gums'."
},
"keywords": {
"type": "string",
"description": "Core product keywords to search (product noun + essential attributes), no 'best'/brand."
},
"max_price": {
"type": "number",
"description": "Optional price ceiling."
},
"min_price": {
"type": "number",
"description": "Optional price floor."
},
"attributes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tokens that MUST appear in the product title, e.g. ['3.5mm'] or ['5090']."
},
"exclude_terms": {
"type": "array",
"items": {
"type": "string"
},
"description": "Words indicating the WRONG product, e.g. ['ethernet','usb'] for an audio patch cable."
},
"category_hints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Category words the right product lives in, e.g. ['instrument cables','audio cables']."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
}
}
}| min_total_asins |
| number |
| max_total_brands | number |
| min_total_brands | number |
| max_avg_rating_count | number |
| min_avg_rating_count | number |
| seller_name_contains | string |
| max_new_brands_in_window | number |
| max_operator_fba_share_pct | number |
| min_operator_fba_share_pct | number |
| max_total_observed_buybox_days | number |
| min_total_observed_buybox_days | number |
{
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"seller_name": {
"type": "string",
"description": "Exact seller/operator name (case-insensitive)."
},
"window_days": {
"type": "integer",
"description": "Days back for 'new' brands (default 30, max 90)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_avg_rating": {
"type": "number"
},
"min_avg_rating": {
"type": "number"
},
"min_new_brands": {
"type": "integer",
"description": "Minimum new-brand count to surface (default 3)."
},
"max_total_asins": {
"type": "number"
},
"min_total_asins": {
"type": "number"
},
"max_total_brands": {
"type": "number"
},
"min_total_brands": {
"type": "number"
},
"max_avg_rating_count": {
"type": "number"
},
"min_avg_rating_count": {
"type": "number"
},
"seller_name_contains": {
"type": "string"
},
"max_new_brands_in_window": {
"type": "number"
},
"max_operator_fba_share_pct": {
"type": "number"
},
"min_operator_fba_share_pct": {
"type": "number"
},
"max_total_observed_buybox_days": {
"type": "number"
},
"min_total_observed_buybox_days": {
"type": "number"
}
}
}| exclude_gated |
| boolean |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| max_retail_price | number |
| min_retail_price | number |
| exclude_amazon_pl | boolean |
| max_margin_signal | number |
| min_margin_signal | number |
| min_velocity_score | integer | Minimum velocity sub-score (0-100). >=90 = 'rising demand' (top ~3%%), >=70 = 'moderate growth' (top ~10%%). >=50 covers 97%% of ASINs and is not a meaningful filter. |
| max_composite_score | number |
| min_composite_score | number |
| max_sold_30d_revenue | number |
| min_sold_30d_revenue | number |
| max_gating_risk_score | number |
| max_number_of_ratings | number |
| min_gating_risk_score | number |
| min_number_of_ratings | number |
| product_title_contains | string | Keyword title search across the WHOLE catalog (FULLTEXT, token-AND any order — may also match the product description), ranked by sourcing score. Broader recall than a literal substring: 'ceiling fan mount' matches titles containing all three words in any order. |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"brand": {
"type": "string"
},
"limit": {
"type": "integer",
"description": "Number of products to return (default 10, max 50)."
},
"scope": {
"enum": [
"tracked",
"universe"
],
"type": "string",
"description": "tracked = only ASINs from brands on the user's watchlist; universe = all. Default universe."
},
"category": {
"type": "string"
},
"max_rating": {
"type": "number"
},
"min_rating": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"exclude_gated": {
"type": "boolean"
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_retail_price": {
"type": "number"
},
"min_retail_price": {
"type": "number"
},
"exclude_amazon_pl": {
"type": "boolean"
},
"max_margin_signal": {
"type": "number"
},
"min_margin_signal": {
"type": "number"
},
"min_velocity_score": {
"type": "integer",
"description": "Minimum velocity sub-score (0-100). >=90 = 'rising demand' (top ~3%%), >=70 = 'moderate growth' (top ~10%%). >=50 covers 97%% of ASINs and is not a meaningful filter."
},
"max_composite_score": {
"type": "number"
},
"min_composite_score": {
"type": "number"
},
"max_sold_30d_revenue": {
"type": "number"
},
"min_sold_30d_revenue": {
"type": "number"
},
"max_gating_risk_score": {
"type": "number"
},
"max_number_of_ratings": {
"type": "number"
},
"min_gating_risk_score": {
"type": "number"
},
"min_number_of_ratings": {
"type": "number"
},
"product_title_contains": {
"type": "string",
"description": "Keyword title search across the WHOLE catalog (FULLTEXT, token-AND any order — may also match the product description), ranked by sourcing score. Broader recall than a literal substring: 'ceiling fan mount' matches titles containing all three words in any order."
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| exclude_amazon_pl | boolean | Exclude Amazon private label brands. Default true. |
| max_control_score | number |
| min_control_score | number |
| max_sold_30d_revenue | number |
| max_winner_diversity | number |
| min_sold_30d_revenue | number |
| min_winner_diversity | number |
| max_seller_churn_30d_pct | number |
| min_seller_churn_30d_pct | number |
| max_pct_asins_gated_to_3p | number |
| min_pct_asins_gated_to_3p | number |
| dominant_category_velocity_tier_in | string | Comma-separated velocity tiers to keep. |
| max_seller_churn_30d_delta_vs_cat_pp | number |
| min_seller_churn_30d_delta_vs_cat_pp | number |
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Exact brand match (case-insensitive)."
},
"limit": {
"type": "integer",
"description": "Max results (capped at 10). Default 10."
},
"scope": {
"enum": [
"tracked",
"universe"
],
"type": "string",
"description": "tracked = only brands on the user's watchlist; universe = all brands. Default universe."
},
"category": {
"type": "string",
"description": "Category root name to filter (optional)."
},
"min_velocity": {
"type": "number",
"description": "Minimum units/day threshold (optional)."
},
"exclude_gated": {
"type": "boolean",
"description": "Exclude brands gated to 3P sellers. Default true."
},
"brand_contains": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"exclude_amazon_pl": {
"type": "boolean",
"description": "Exclude Amazon private label brands. Default true."
},
"max_control_score": {
"type": "number"
},
"min_control_score": {
"type": "number"
},
"max_sold_30d_revenue": {
"type": "number"
},
"max_winner_diversity": {
"type": "number"
},
"min_sold_30d_revenue": {
"type": "number"
},
"min_winner_diversity": {
"type": "number"
},
"max_seller_churn_30d_pct": {
"type": "number"
},
"min_seller_churn_30d_pct": {
"type": "number"
},
"max_pct_asins_gated_to_3p": {
"type": "number"
},
"min_pct_asins_gated_to_3p": {
"type": "number"
},
"dominant_category_velocity_tier_in": {
"type": "string",
"description": "Comma-separated velocity tiers to keep."
},
"max_seller_churn_30d_delta_vs_cat_pp": {
"type": "number"
},
"min_seller_churn_30d_delta_vs_cat_pp": {
"type": "number"
}
}
}| integer |
| 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR |
| first_seen_from | string | YYYY-MM-DD. |
| operator_type_in | string | Comma-separated classifications to keep (cold path only, when no authorized list is set): e.g. arbitrage, reseller, amazon, brand-direct, authorized-retailer. |
| max_asins_touched | number |
| min_asins_touched | number |
| authorized_sellers | array | Optional. Authorized seller names — sellers NOT in this list are flagged. If omitted (and none saved), all buy-box-winning sellers are returned, classified. |
| seller_name_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
{
"type": "object",
"required": [
"brand"
],
"properties": {
"brand": {
"type": "string",
"description": "Brand name (case-insensitive)."
},
"limit": {
"type": "integer"
},
"seller_name": {
"type": "string",
"description": "Exact seller name (case-insensitive)."
},
"last_seen_to": {
"type": "string"
},
"first_seen_to": {
"type": "string"
},
"max_avg_price": {
"type": "number"
},
"min_avg_price": {
"type": "number"
},
"last_seen_from": {
"type": "string"
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"first_seen_from": {
"type": "string",
"description": "YYYY-MM-DD."
},
"operator_type_in": {
"type": "string",
"description": "Comma-separated classifications to keep (cold path only, when no authorized list is set): e.g. arbitrage, reseller, amazon, brand-direct, authorized-retailer."
},
"max_asins_touched": {
"type": "number"
},
"min_asins_touched": {
"type": "number"
},
"authorized_sellers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional. Authorized seller names — sellers NOT in this list are flagged. If omitted (and none saved), all buy-box-winning sellers are returned, classified."
},
"seller_name_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
}
}
}| max_composite_score | number |
| min_composite_score | number | Only candidates with sourcing composite score >= this. |
| max_buybox_avg_price | number |
| min_buybox_avg_price | number |
| product_title_contains | string |
| max_observed_buybox_days | number |
| min_observed_buybox_days | number |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "Specific ASIN to add. If provided, brand is ignored."
},
"brand": {
"type": "string",
"description": "Brand name to find watchable ASINs for."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_composite_score": {
"type": "number"
},
"min_composite_score": {
"type": "number",
"description": "Only candidates with sourcing composite score >= this."
},
"max_buybox_avg_price": {
"type": "number"
},
"min_buybox_avg_price": {
"type": "number"
},
"product_title_contains": {
"type": "string"
},
"max_observed_buybox_days": {
"type": "number"
},
"min_observed_buybox_days": {
"type": "number"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| max_score_delta | number |
| min_score_delta | number |
| max_current_score | number |
| min_current_score | number | Only tracked ASINs with current sourcing score >= this. |
| max_previous_score | number |
| min_previous_score | number |
| product_brand_contains | string |
| product_title_contains | string |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"limit": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"since_days": {
"type": "integer",
"description": "How far back to look for changes (default 7, max 30)."
},
"asin_contains": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. One marketplace per call."
},
"max_score_delta": {
"type": "number"
},
"min_score_delta": {
"type": "number"
},
"max_current_score": {
"type": "number"
},
"min_current_score": {
"type": "number",
"description": "Only tracked ASINs with current sourcing score >= this."
},
"max_previous_score": {
"type": "number"
},
"min_previous_score": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| max_new_sellers |
| number |
| max_score_delta | number |
| min_new_sellers | number | Only ASINs that gained at least this many new sellers. |
| min_score_delta | number |
| max_current_score | number |
| min_current_score | number |
| max_dropped_sellers | number |
| min_dropped_sellers | number |
| product_brand_contains | string |
| product_title_contains | string |
| max_current_seller_count | number |
| min_current_seller_count | number |
| max_fulfillment_amz_dom_pct | number |
| max_fulfillment_fba_pen_pct | number |
| min_fulfillment_amz_dom_pct | number |
| min_fulfillment_fba_pen_pct | number |
{
"type": "object",
"required": [
"name"
],
"properties": {
"asin": {
"type": "string",
"description": "Only the change row for this exact ASIN."
},
"name": {
"type": "string",
"description": "The list name to diff."
},
"list_type": {
"enum": [
"asin",
"brand",
"seller",
"niche"
],
"type": "string",
"default": "asin",
"description": "Defaults to asin."
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"max_new_sellers": {
"type": "number"
},
"max_score_delta": {
"type": "number"
},
"min_new_sellers": {
"type": "number",
"description": "Only ASINs that gained at least this many new sellers."
},
"min_score_delta": {
"type": "number"
},
"max_current_score": {
"type": "number"
},
"min_current_score": {
"type": "number"
},
"max_dropped_sellers": {
"type": "number"
},
"min_dropped_sellers": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"product_title_contains": {
"type": "string"
},
"max_current_seller_count": {
"type": "number"
},
"min_current_seller_count": {
"type": "number"
},
"max_fulfillment_amz_dom_pct": {
"type": "number"
},
"max_fulfillment_fba_pen_pct": {
"type": "number"
},
"min_fulfillment_amz_dom_pct": {
"type": "number"
},
"min_fulfillment_fba_pen_pct": {
"type": "number"
}
}
}| product_brand | string | Exact product brand (case-insensitive). |
| fulfillment_in | string | Comma-separated FBA/FBM/AMZ to keep. |
| marketplace_id | integer | Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. One marketplace per call. |
| max_seller_count | number |
| min_seller_count | number | Only ASINs with >= this many distinct sellers. |
| max_composite_score | number |
| min_composite_score | number | Only tracked ASINs with composite sourcing score >= this. |
| max_buybox_share_pct | number |
| min_buybox_share_pct | number | Only ASINs where the buy-box leader's share >= this percent. |
| max_amz_dominance_pct | number |
| min_amz_dominance_pct | number | Only ASINs with Amazon buy-box dominance >= this percent. |
| product_brand_contains | string |
| max_fba_penetration_pct | number |
| min_fba_penetration_pct | number | Only ASINs with FBA penetration >= this percent. |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"sort": {
"enum": [
"score",
"seller_count",
"buybox_share",
"amz_dominance",
"fba_penetration",
"price"
],
"type": "string",
"description": "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": {
"type": "integer"
},
"max_price": {
"type": "number"
},
"min_price": {
"type": "number"
},
"asin_contains": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR. One marketplace per call."
},
"max_seller_count": {
"type": "number"
},
"min_seller_count": {
"type": "number",
"description": "Only ASINs with >= this many distinct sellers."
},
"max_composite_score": {
"type": "number"
},
"min_composite_score": {
"type": "number",
"description": "Only tracked ASINs with composite sourcing score >= this."
},
"max_buybox_share_pct": {
"type": "number"
},
"min_buybox_share_pct": {
"type": "number",
"description": "Only ASINs where the buy-box leader's share >= this percent."
},
"max_amz_dominance_pct": {
"type": "number"
},
"min_amz_dominance_pct": {
"type": "number",
"description": "Only ASINs with Amazon buy-box dominance >= this percent."
},
"product_brand_contains": {
"type": "string"
},
"max_fba_penetration_pct": {
"type": "number"
},
"min_fba_penetration_pct": {
"type": "number",
"description": "Only ASINs with FBA penetration >= this percent."
}
}
}| domain_contains | string | Substring match on the cheapest-source domain. |
| violations_only | boolean | Keep only ASINs with one or more web MAP violations. |
| unauthorized_only | boolean | Keep only ASINs with one or more unauthorized web sellers. |
| max_web_source_count | number |
| min_web_source_count | number | Only ASINs with at least this many distinct open-web sources. |
| max_cheapest_web_price | number |
| min_cheapest_web_price | number |
| product_brand_contains | string |
| max_web_violation_count | number |
| min_web_violation_count | number | Only ASINs with at least this many MAP-violating web sources. |
{
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "Exact ASIN match."
},
"sort": {
"enum": [
"web_violations",
"cheapest_web_price",
"web_savings_vs_amazon",
"last_scan"
],
"type": "string",
"description": "Order: web_violations (most MAP breaches first), cheapest_web_price, web_savings_vs_amazon (biggest off-Amazon discount first), last_scan."
},
"limit": {
"type": "integer"
},
"asin_contains": {
"type": "string"
},
"product_brand": {
"type": "string",
"description": "Exact product brand (case-insensitive)."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Marketplace to scope the watchlist to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US, 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR."
},
"domain_contains": {
"type": "string",
"description": "Substring match on the cheapest-source domain."
},
"violations_only": {
"type": "boolean",
"description": "Keep only ASINs with one or more web MAP violations."
},
"unauthorized_only": {
"type": "boolean",
"description": "Keep only ASINs with one or more unauthorized web sellers."
},
"max_web_source_count": {
"type": "number"
},
"min_web_source_count": {
"type": "number",
"description": "Only ASINs with at least this many distinct open-web sources."
},
"max_cheapest_web_price": {
"type": "number"
},
"min_cheapest_web_price": {
"type": "number"
},
"product_brand_contains": {
"type": "string"
},
"max_web_violation_count": {
"type": "number"
},
"min_web_violation_count": {
"type": "number",
"description": "Only ASINs with at least this many MAP-violating web sources."
}
}
}| number |
| max_match_confidence | number |
| min_match_confidence | number | Only matched pairs with Amazon<->Walmart match confidence >= this. |
| product_title_contains | string |
| max_delta_pct_amz_vs_wmt | number |
| max_est_arbitrage_profit | number |
| min_delta_pct_amz_vs_wmt | number | Only pairs whose Amazon-vs-Walmart price delta percentage is >= this. |
| min_est_arbitrage_profit | number |
{
"type": "object",
"properties": {
"asin": {
"type": "string"
},
"brand": {
"type": "string"
},
"fulfillment_in": {
"type": "string",
"description": "Comma-separated FBA/FBM/AMZ to keep."
},
"marketplace_id": {
"type": "integer",
"default": 2,
"description": "Amazon-side marketplace for the comparison (Walmart US is always the other side). 1 = Amazon UK, 2 = Amazon US (default), 4 = Amazon CA, 5 = Amazon AU, 6 = Amazon DE, 7 = Amazon JP, 8 = Amazon IT, 9 = Amazon FR, 10 = Amazon ES, 11 = Amazon MX, 12 = Amazon BR"
},
"max_amazon_price": {
"type": "number"
},
"min_amazon_price": {
"type": "number"
},
"max_walmart_price": {
"type": "number"
},
"min_walmart_price": {
"type": "number"
},
"max_match_confidence": {
"type": "number"
},
"min_match_confidence": {
"type": "number",
"description": "Only matched pairs with Amazon<->Walmart match confidence >= this."
},
"product_title_contains": {
"type": "string"
},
"max_delta_pct_amz_vs_wmt": {
"type": "number"
},
"max_est_arbitrage_profit": {
"type": "number"
},
"min_delta_pct_amz_vs_wmt": {
"type": "number",
"description": "Only pairs whose Amazon-vs-Walmart price delta percentage is >= this."
},
"min_est_arbitrage_profit": {
"type": "number"
}
}
}