Get Rankings

Visibility rankings per AI model and per prompt, with optional search volume data.

Requires authentication

60 req/min

Endpoint

GET/get-rankings

Returns visibility ranking data for your brand across AI models. Use different view modes to get overall scores or per-prompt breakdowns with optional search volume enrichment.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands

viewstring

View mode: overall, by-prompt

Default: overall

daysinteger

Lookback period in days (7-365)

Default: 30

include_volumeboolean

Merge search volume data (only for view=by-prompt)

Default: false

This endpoint is rate limited to 60 requests per minute per API key. See the Rate Limits page for handling 429 responses.

view=overall (default)

Returns aggregated visibility scores and ranking metrics across all AI models. This is the default view when no view parameter is provided.

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-rankings?brand_id=BRAND_ID&days=30'

200 OK

1{
2  "brand": { "id": "...", "name": "Notion" },
3  "your_rank": 2,
4  "total_competitors": 6,
5  "your_visibility": 72.4,
6  "your_visibility_change": 3.1,
7  "win_rate": 61.5,
8  "threat_count": 2,
9  "rankings": [
10    {
11      "rank": 1,
12      "name": "Competitor A",
13      "visibility": 79.8,
14      "visibility_change": 1.2,
15      "is_you": false,
16      "h2h_win_rate": 48.5
17    },
18    {
19      "rank": 2,
20      "name": "Notion",
21      "visibility": 72.4,
22      "visibility_change": 3.1,
23      "is_you": true,
24      "h2h_win_rate": null
25    }
26  ]
27}

Model Ranking

rankinteger

Leaderboard rank among tracked competitors

namestring

Competitor or brand name

visibilitynumber

Visibility score (0-100)

visibility_changenumbernullable

Change vs previous period

is_youboolean

True for your brand row

h2h_win_ratenumbernullable

Head-to-head win rate vs your brand (percent)

view=by-prompt

Returns per-prompt ranking data with market-level breakdowns. Each prompt includes one or more markets entries with a location-specific visibility score.

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-rankings?brand_id=BRAND_ID&view=by-prompt&days=30'

200 OK

1{
2  "brand": { "id": "...", "name": "Notion" },
3  "prompts": [
4    {
5      "prompt_id": "abc-123",
6      "prompt_text": "best project management tools 2026",
7      "markets": [
8        {
9          "location": "US",
10          "is_primary": true,
11          "score": 74.2
12        },
13        {
14          "location": "UK",
15          "is_primary": false,
16          "score": 68.1
17        }
18      ]
19    }
20  ]
21}

Prompt Market

locationstring

Market/location label (e.g. US, UK)

is_primaryboolean

Whether this market is the brand primary market

scorenumber

Visibility score for this prompt in the market (0-100)

search_volumeintegernullable

Optional monthly search volume (when include_volume=true)

priority_scorenumbernullable

Optional merged priority score (when include_volume=true)

include_volume

Add include_volume=true to any view=by-prompt request to merge search demand signals into each market row. You will receivesearch_volume and priority_scoreinside each markets[] item when available.

Request with Volume

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-rankings?brand_id=BRAND_ID&view=by-prompt&include_volume=true'

200 OK

1{
2  "brand": { "id": "...", "name": "Notion" },
3  "prompts": [
4    {
5      "prompt_id": "abc-123",
6      "prompt_text": "best project management tools 2026",
7      "markets": [
8        {
9          "location": "US",
10          "is_primary": true,
11          "score": 74.2,
12          "search_volume": 12400,
13          "priority_score": 82.0
14        }
15      ]
16    }
17  ]
18}

Volume Data

search_volumeintegernullable

Estimated monthly search volume for the prompt

priority_scorenumbernullable

Composite priority score merged from volume/intent

Use volume data to prioritize prompts where you rank well AND have high search traffic. Sort by markets[].search_volume descending to find your highest-impact opportunities.

Use Cases

Track overall brand visibility across all AI models
Identify which models favor your brand and which need improvement
Analyze per-prompt performance to find optimization opportunities
Prioritize high-volume prompts with include_volume=true
Monitor ranking trends over different time periods with the days parameter

Code Example

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-rankings?brand_id=BRAND_ID&days=30'

200 OK

1{
2  "brand": { "id": "...", "name": "Notion" },
3  "your_rank": 2,
4  "total_competitors": 6,
5  "your_visibility": 72.4,
6  "your_visibility_change": 3.1,
7  "win_rate": 61.5,
8  "threat_count": 2,
9  "rankings": [
10    {
11      "rank": 1,
12      "name": "Competitor A",
13      "visibility": 79.8,
14      "visibility_change": 1.2,
15      "is_you": false,
16      "h2h_win_rate": 48.5
17    },
18    {
19      "rank": 2,
20      "name": "Notion",
21      "visibility": 72.4,
22      "visibility_change": 3.1,
23      "is_you": true,
24      "h2h_win_rate": null
25    }
26  ]
27}

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-rankings?brand_id=BRAND_ID&days=30'

200 OK

1{
2  "brand": { "id": "...", "name": "Notion" },
3  "your_rank": 2,
4  "total_competitors": 6,
5  "your_visibility": 72.4,
6  "your_visibility_change": 3.1,
7  "win_rate": 61.5,
8  "threat_count": 2,
9  "rankings": [
10    {
11      "rank": 1,
12      "name": "Competitor A",
13      "visibility": 79.8,
14      "visibility_change": 1.2,
15      "is_you": false,
16      "h2h_win_rate": 48.5
17    },
18    {
19      "rank": 2,
20      "name": "Notion",
21      "visibility": 72.4,
22      "visibility_change": 3.1,
23      "is_you": true,
24      "h2h_win_rate": null
25    }
26  ]
27}