AASINRating

get_top100

Get the Best Sellers Rank list (rank 1..N) for either a whole top-level category or a single subcategory. Ranking is an objective representation of Amazon's official best-seller list, presented without evaluation.

When to use: after list_categories, to pull the ranked list that anchors category research.

Parameters

NameTypeRequiredDescription
category_idstringone of twoSlug of a top-level category (from list_categories)
subcategory_idstringone of twoNumeric node id of a single subcategory (from list_categories)

Provide exactly one of the two. Rankings are per subcategory list (rank 1..N).

Example call

{
  "jsonrpc": "2.0", "id": 4, "method": "tools/call",
  "params": {
    "name": "get_top100",
    "arguments": {"subcategory_id": "7073960011"}
  }
}

Response shape

{
  "category": {"category_id": "...", "name": "..."},
  "list_size": 100,
  "top100": [
    {
      "rank": 1,
      "bsr_subcategory_rank": 1,
      "subcategory_id": "7073960011",
      "asin": "B01MTB55WH",
      "brand": "Anker",
      "title": "Portable Charger ...",
      "rating": 4.6,
      "review_count": 25000,
      "rating_distribution": {"five_star": 78, "four_star": 14, "...": "..."},
      "price": 29.99,
      "price_as_of": "2026-11-04T08:12:00Z",
      "product_url": "https://www.amazon.com/dp/B01MTB55WH",
      "buyer_signal": null
    }
  ],
  "notes": {"...": "..."}
}

*(abbreviated for readability)*

Field notes

FieldDescription
rankPosition in this list (1-based, contiguous)
bsr_subcategory_rankBest Sellers Rank within the subcategory as observed
rating / review_countSnapshot values at collection time
rating_distributionFull 5-to-1 star percentage breakdown
price / price_as_ofObserved price snapshot with its UTC timestamp — not real-time
product_urlPlain Amazon product page, no promotional tags
buyer_signalavoid_strong only when a high-confidence red flag exists; otherwise absent

Tool note

> BSR ranking is an objective representation of Amazon's official best-seller list, presented without evaluation. Rankings update over time; see data_as_of for the data timestamp. Prices are snapshots (see price_as_of); for a real-time quote call scrap_page or open product_url. For side-by-side comparison, call compare_products with 2-5 ASINs.

Related tools