---
title: "Read the score series"
method: GET
path: "/trackers/{id}/scores"
tags: ["Results"]
---

# Read the score series

`GET /trackers/{id}/scores`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/trackers/{id}/scores`
- Auth: HTTP bearer

The score series, one row per analyst, keyword, engine, version and period.

## Query parameters

- `analyst` 'keyword_presence' | 'share_of_voice' | 'sentiment'
- `engine` 'chatgpt' | 'claude' | 'gemini' | 'perplexity' | 'mistral' | 'grok': The AI assistants the questions are asked to.

## Response `200`

The score series.

- object
  - `scores` Score[], required
    - `analyst` 'keyword_presence' | 'share_of_voice' | 'sentiment' | 'custom_prompt', required: `keyword_presence` and `share_of_voice` are deterministic; `sentiment` and `custom_prompt` are AI analysts, billed per analyzed response.
    - `keyword` string, required
    - `favorite` boolean, required
    - `engine` 'chatgpt' | 'claude' | 'gemini' | 'perplexity' | 'mistral' | 'grok', required: The AI assistants the questions are asked to.
    - `panel_version` integer, required
    - `period_start` string, date, required
    - `on_demand` boolean, required
    - `citation_rate` number, nullable, required
    - `weighted_score` number, nullable, required
    - `share_of_voice` number, nullable, required
    - `sentiment` object, nullable, required: The counts of the sentiment analyst, present on its rows.
      - `positive` integer
      - `neutral` integer
      - `negative` integer
    - `runs_counted` integer, required
    - `computed_at` string, date-time, required

## Other responses

- `400`: `bad_request`: malformed body or parameter; the message says what.
- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/epovest/apis/epovest-api.md) · [All operations](https://skmtc.dev/epovest/apis/epovest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/epovest/apis/epovest-api/revisions/7a78ee27ecbb?raw)