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, prompt-trends

Default: overall

daysinteger

Lookback period in days (1-365)

Default: 30

include_volumeboolean

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

Default: false

tag_idsstring

Comma-separated tag UUIDs from /get-tags. Recalculates over only those prompts. Applies to view=overall and view=prompt-trends.

limitinteger

view=prompt-trends only: how many prompts to return, most-measured first. 1 to 100.

Default: 25

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.

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.

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)

view=prompt-trends

Returns a daily position series per prompt for your brand and for the competitors you meet on that prompt. This is the view that answers which specific prompts you are losing, and since when, rather than only where you stand today.

Position is the average rank your brand holds in the answer, so lower is better. A positive position_change means the brand slipped down.

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

200 OK

1{
2  "brand": { "id": "00000000-0000-4000-8000-81f286d10c3c", "name": "Notion" },
3  "prompts": [
4    {
5      "prompt_text": "best project management tool",
6      "your_positions": [
7        { "date": "2026-08-18", "position": 2.0 },
8        { "date": "2026-08-24", "position": 4.0 }
9      ],
10      "competitors": {
11        "Coda": [
12          { "date": "2026-08-18", "position": 3.0 },
13          { "date": "2026-08-24", "position": 1.0 }
14        ]
15      },
16      "days_with_data": 2,
17      "best_position": 2.0,
18      "worst_position": 4.0,
19      "latest_position": 4.0,
20      "position_change": 2.0
21    }
22  ],
23  "period_days": 90,
24  "total_prompts_with_trends": 34,
25  "tag_ids": [],
26  "data_through": "2026-08-24",
27  "note": "position is average rank in the answer: lower is better, and a positive position_change means the brand slipped."
28}

Prompt Trend

prompt_textstring

The tracked prompt

your_positionsarray

Daily points of { date, position } for your brand

competitorsobject

Competitor name to their daily position points on this prompt

days_with_datainteger

Number of days your brand was measured on this prompt

best_positionnumbernullable

Best (lowest) position in the window

worst_positionnumbernullable

Worst (highest) position in the window

latest_positionnumbernullable

Most recent position

position_changenumbernullable

Latest minus first. Positive means you slipped.

Prompts come back most-measured first. Use limit to control how many you receive and total_prompts_with_trends to see how many exist. A window shorter than 7 days is widened to 7, and anything above 90 is held at 90, which is the depth the pipeline keeps.

Filtering by tag

Pass tag_ids to recalculate view=overall or view=prompt-trends over only the prompts carrying those tags. Tag UUIDs come from /get-tags. The response echoes the tags it used so a filtered slice is never mistaken for the whole picture.

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.

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
Find the prompts you are losing, and when it started, with view=prompt-trends
Report on a single business line by passing tag_ids

Code example

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}

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}