What is Website Category Ranking Metrics?
Compare a domain’s ranking metrics across product categories between two dates. The category view helps you study where its search position changed rather than treating the domain as one total.
Settings Website Category Ranking Metrics takes
You describe the task in plain words and your AI assistant fills these in. In code you pass them yourself.
| Setting | What it controls | Tip |
|---|---|---|
| First date | First date of comparison period | Required |
| Second date | Second date of comparison period | Required |
| Category codes | Category codes from the Labs categories dictionary (1-5). | Required |
| Limit | Rows to return (1-1000, default 100). | Optional · 1 to 1000 |
| Offset | Rows to skip before the first returned row. | Optional |
| Etv max | Maximum current organic ETV of the domain | Optional |
| Etv min | Minimum current organic ETV of the domain | Optional |
| Filters | Filter rules as nested arrays: [["field","op",value], "and", [...]], operators =, <>, <, <=, >, >=, in, not_in, like, not_like, regex, not_regex, match, not_match; up to 8 rules. Field names come from this API's filters… | Optional |
| Order by | Sort rules as 'field,asc' or 'field,desc', e.g. ['keyword_info.search_volume,desc']; up to 3. | Optional |
| Correlate | Correlate data with previously obtained datasets (default true) | Optional |
| Item types | Display results by item type (default ['organic', 'paid']; values: ['organic', 'paid', featured snippet, local pack]) | Optional |
| Language code | Language code, e.g. 'en'. Give language_name or language_code. | Optional · up to 10 characters |
| Language name | Full language name, e.g. 'English'. Give language_name or language_code. | Optional · up to 60 characters |
| Location code | Numeric location code from the locations dictionary, e.g. 2840 (United States). Give one of location_name, location_code, or location_coordinate. | Optional |
| Location name | Full location name exactly as listed in the locations dictionary, e.g. 'London,England,United Kingdom' or 'United States'. Give one of location_name, location_code, or location_coordinate. | Optional · up to 200 characters |
| Include subdomains | Return subdomains in the API response (default true) | Optional |
| Top categories count | Number of additional domain categories (max 5) | Optional · -9.0072e+15 to 5 |
How to use Website Category Ranking Metrics with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Describe the task
Say what you need in one sentence, including the first date.
Get the result
Your assistant runs Website Category Ranking Metrics and shows what came back.
Keep going in the chat
Ask it to filter, compare or summarize the result, or to save it as a table.
Ways to use it
- For a search-research brief: compare a domain's ranking metrics across product categories between two dates to see which areas gained or lost visibility.
Website Category Ranking Metrics in your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key, so a backend, a script or a scheduled job can call Website Category Ranking Metrics directly. Start with the Toolbox REST quickstart.
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Each run is billed from your AI/ML API balance, with no subscription or seat fee. Check the current price in your dashboard before large runs.
FAQ
Do I need a separate account for Website Category Ranking Metrics?
No. It runs on your AI/ML API account and balance, from your AI assistant over MCP or from your code over REST.
Which AI assistants can use it?
Claude, ChatGPT, Cursor, Hermes, OpenClaw and other MCP clients. Add the AI/ML API MCP server once with the MCP quickstart.
Run Website Category Ranking Metrics from your assistant
Connect once, then ask for it in plain words.