Best / most popular product in a category
best_in_categoryAnswers "what is the best / most popular / most used X". Returns a one-sentence answer, the #1 and #2, the cheapest product in the top five, the fastest riser, the top 10, the sources the estimate is based on and the page URL. Shares are estimated % of builds/purchases. Optional region, brand ("AMD", "Intel", "NVIDIA"), os ("macOS", "Windows") and budget_usd.
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": "best_in_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | Laptops only: macOS or Windows | |
| brand | No | Only this brand, e.g. AMD | |
| 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. | |
| budget_usd | No | Also return the most picked product at or under this US price |