amazon-product-research-mcp

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'The product / OEM query (brand-free for private label).'}}}

{'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.'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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).'}}}

{'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).'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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).'}}}

{'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'}}}

{'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'}}}

{'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."}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'type': 'object', 'properties': {'limit': {'type': 'integer'}, 'niche': {'type': 'string', 'description': 'Exact niche (subcategory) name, case-insensitive.'}, 'price_max': {'type': 'number', 'description': 'Maximum average price USD (default 70 — the PL margin band).'}, 'price_min': {'type': 'number', 'description': 'Minimum average price USD (default 20 — the PL margin band).'}, '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', '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.'}}}

{'type': 'object', 'required': ['keyword'], 'properties': {'keyword': {'type': 'string', 'description': "The exact keyword to check (e.g. 'electric toothbrush')."}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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)."}}}

{'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'}}}

{'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.'}}}

{'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.'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'type': 'object', 'required': ['operator_name'], 'properties': {'operator_name': {'type': 'string', 'description': 'Seller/operator name.'}}}

{'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.'}}}

{'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.'}}}

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}}}

{'type': 'object', 'required': ['name', 'schedule'], 'properties': {'name': {'type': 'string'}, 'schedule': {'enum': ['manual', 'daily', 'weekly'], 'type': 'string'}}}

{'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.'}}}

{'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'}}}

{'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'}}}

{'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).'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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).'}}}

{'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'}}}

{'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'}}}

{'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'}}}

{'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.'}}}

{'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'}}}

{'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.'}}}

{'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.'}}}

{'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.'}}}

{'type': 'object', 'required': ['query'], 'properties': {'count': {'type': 'integer', 'default': 10, 'description': 'Max results (default 10, cap 20).'}, 'query': {'type': 'string', 'description': 'The search query.'}}}

{'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'}}}