AASINRating

get_brand

Get a brand's full profile from the brand registry: tier, product count, cumulative review count, rating breakdown, seller positive percentage, subcategory monopoly HHI, 90-day trend, and ratings gained over 30/90 days. Pass a brand_name for an exact match, or a partial name to receive candidate matches.

When to use: researching a brand's market footprint and concentration; pass an exact brand_name or a partial name to receive candidate matches.

Parameters

NameTypeRequiredDescription
brand_namestringyesExact brand name, or a partial name to receive candidate matches

Example call

{
  "jsonrpc": "2.0", "id": 12, "method": "tools/call",
  "params": {
    "name": "get_brand",
    "arguments": {"brand_name": "Samsung"}
  }
}

Response shape

{
  "brand": {
    "brand_name": "Samsung",
    "category_ids": ["Electronics"],
    "product_count": 12,
    "variant_count": 30,
    "review_count_total": 120000,
    "avg_rating": 4.5,
    "rating_breakdown": {"five_pct": 74.0, "four_pct": 10.8, "three_pct": 6.0, "two_pct": 3.0, "one_pct": 6.6},
    "seller_positive_pct": 0.92,
    "buybox_share_30d": 0.85,
    "monopoly_hhi": 0.12,
    "ratings_gained_30d": null,
    "ratings_gained_90d": null,
    "trend_90d": null,
    "tier": "head",
    "amazon_buybox_share": 0.85,
    "first_seen_at": "2026-11-04T00:00:00Z",
    "updated_at": "2026-11-04T00:00:00Z",
    "avg_price": 299.99,
    "max_bought_past_month": 5000,
    "best_bsr": 1234,
    "price_bucket": ">$100"
  },
  "notes": {"...": "..."}
}

*(abbreviated for readability)*

Field notes

FieldDescription
tierBrand tier label (an objective registry classification)
product_count / review_count_total / avg_ratingBrand-level aggregate counts and rating
rating_breakdownFull 5-to-1 star percentage breakdown
seller_positive_pct / monopoly_hhiSeller positive percentage and subcategory monopoly HHI
trend_90d / ratings_gained_30d / ratings_gained_90d90-day trend and ratings gained
category_idsCategories the brand appears in

Tool note

> Brand fields are objective registry facts: tier, counts, rating breakdowns, and concentration measures. No evaluation or recommendation is attached.

Related tools