evaluate_brand
Read-only
Evaluate a brand's sales posture, distribution, and product performance to determine portfolio inclusion. Get metrics like revenue, churn rate, and top ASINs.
Instructions
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?'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | Yes | Brand name (case-insensitive). | |
| marketplace_id | No | 1 = Amazon UK, 2 = Amazon US (default) | |
| distribution_verdict_in | No | 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. | |
| asin | No | Keep only this ASIN in top_asins. | |
| asin_contains | No | ||
| min_composite_score | No | ||
| max_composite_score | No | ||
| min_velocity | No | ||
| max_velocity | No | ||
| min_gating | No | ||
| max_gating | No | ||
| min_margin | No | ||
| max_margin | No | ||
| min_rating | No | ||
| max_rating | No | ||
| min_number_of_ratings | No | ||
| max_number_of_ratings | No | ||
| product_brand | No | Exact product brand (case-insensitive) on top_asins. | |
| product_brand_contains | No | ||
| product_title_contains | No | ||
| min_price | No | ||
| max_price | No | ||
| fulfillment_in | No | Comma-separated FBA/FBM/AMZ to keep on top_asins. | |
| min_fulfillment_amz_dom_pct | No | ||
| max_fulfillment_amz_dom_pct | No | ||
| min_fulfillment_fba_pen_pct | No | ||
| max_fulfillment_fba_pen_pct | No |