Full ranking for a category
get_rankingThe ranked list for one category and month: estimated share of 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 | ||
| 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, UK, EU, AU), a market (na, eu, uk, au) or a name like "Australia". Omit for the global ranking. | |
| category | Yes | Category in plain words, e.g. "mascara", "foundation", "lip oil", "setting spray", or an id from list_categories. |