Get Scores

Get visibility metrics and historical trends for a brand. This is the primary endpoint for understanding your AI visibility.

Requires authentication

60 req/min

Endpoint

GET/get-scores

Returns visibility scores, presence metrics, and historical trends for a brand. Includes per-model breakdown and comparison to previous periods.

Query Parameters

brandstringrequired

Brand ID from /get-brands (also accepts brand_id)

daysinteger

Historical period in days (7-365)

Default: 90

tag_idsstring

Comma-separated tag UUIDs to filter prompts. Scores are recalculated using only matching prompts.

prompt_idstring

Single prompt UUID to filter scores to one prompt

Rate limit: 60 requests/minute.

Understanding Scores

Trakkr tracks two key metrics:

Visibility Score (0-100)

How prominently your brand appears when mentioned. Based on position in AI recommendations.

80-100: Excellent

60-79: Good

40-59: Average

0-39: Needs work

Presence Score (0-100)

The percentage of tracked prompts where your brand appears at least once. A brand with 80% presence appears in 80% of relevant AI queries.

A high visibility score with low presence means you dominate a narrow set of queries. Low visibility with high presence means you appear broadly but not prominently.

Filtering by Tag or Prompt

Use tag_ids or prompt_id to segment visibility scores to a subset of prompts. When filters are active, scores are recalculated using only matching prompts, and the response includes afilters_applied object.

Without filters, scores reflect all tracked prompts (existing behavior). Filters are optional and fully backward-compatible.

Response Fields

latest_scores Object

visibilitynumber

Overall visibility score (0-100). Higher = more prominent in AI responses.

presencenumber

Overall presence score (0-100). Percentage of prompts where brand appears.

average_ranknumber

Average position when mentioned (1.0-10.0). Lower is better.

mentionsinteger

Total times brand appeared in AI responses this period

models_mentionedinteger

Count of AI models that mentioned the brand

model_scoresobject

Per-model visibility and presence breakdown

datestring

ISO 8601 timestamp of this report

Model Scores

The model_scores object contains per-model breakdown:

Model Key	AI Model
`ChatGPT`	OpenAI GPT-4o
`Claude`	Anthropic Claude 3.5 Sonnet
`Gemini`	Google Gemini 2.0 Flash
`Perplexity`	Perplexity Sonar
`Grok`	xAI Grok 2

Code Example

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-scores?brand=75ffdeb9-0924-4ff9-8ded-c2470d73d224&days=30'

1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion"
5  },
6  "latest_scores": {
7    "visibility": 42.5,
8    "presence": 58.0,
9    "average_rank": 3.2,
10    "mentions": 127,
11    "models_mentioned": 6
12  },
13  "trend": {
14    "visibility_change": 5.2,
15    "presence_change": 3.1,
16    "direction": "up"
17  }
18}

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-scores?brand=75ffdeb9-0924-4ff9-8ded-c2470d73d224&days=30'

1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion"
5  },
6  "latest_scores": {
7    "visibility": 42.5,
8    "presence": 58.0,
9    "average_rank": 3.2,
10    "mentions": 127,
11    "models_mentioned": 6
12  },
13  "trend": {
14    "visibility_change": 5.2,
15    "presence_change": 3.1,
16    "direction": "up"
17  }
18}