Full ranking for a category
get_rankingThe ranked list for one category and month: estimated share of builds/purchases, change in percentage points vs the previous month, rank last month, US price, and the sources behind it. Optional region.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"category": "<category>"
},
"name": "get_ranking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | Laptops only: macOS or Windows | |
| brand | No | Only this brand | |
| limit | No | Max products (default 10) | |
| month | No | Month as YYYY-MM. Defaults to the latest month. | |
| region | No | Optional region: a code (US, CA, UK, EU, SE, NO, DK, AU), a market (na, eu, uk, nordics, au) or a name like "Sweden". Omit for the global ranking. | |
| category | Yes | Category in plain words, e.g. "gaming mouse", "CPU", "graphics card", "laptop for video editing", or an id from list_categories. |