---
title: "Get tracked prompt performance"
method: GET
path: "/api/sites/multiscreen/{site_name}/aeo/tracked-prompts"
tags: ["AEO Analytics"]
---

# Get tracked prompt performance

`GET /api/sites/multiscreen/{site_name}/aeo/tracked-prompts`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/aeo/tracked-prompts`
- Auth: HTTP basic

Returns how the site's own brand performed on each active prompt over the requested period: its visibility score, sentiment and average position.

Returns up to 25 prompts, sorted by `ai_visibility_score`, highest first. Archived prompts are left out. Prompts with no data in the period return `0` for score, sentiment and position.

## Path parameters

- `site_name` string, required

## Query parameters

- `from` string, date, required
- `to` string, date, required
- `geos` string[]
- `limit` string
- `offset` string

## Response `200`

OK

- ApiAeoTrackedPromptsResp
  - `from` string, date: First day of the period (UTC).
  - `limit` integer: Page size applied for request
  - `offset` integer: Offset applied for request
  - `prompts` ApiAeoTrackedPromptResp[]: Up to 25 active prompts, by `ai_visibility_score`, highest first.
    - `ai_visibility_score` number, double: Percentage of answers to this prompt that mention the site's own brand, from 0 to 100.
    - `id` string: Prompt ID.
    - `position` number, double, nullable: The own brand's average rank in answers to this prompt. Lower is better; `0` means no data.
    - `prompt` string: The prompt text.
    - `sentiment` number, double, nullable: How positively the answers describe the own brand, from 0 to 100. 50 is neutral.
    - `volume` integer: Estimated search volume for the prompt.
  - `to` string, date: Last day of the period (UTC).
  - `total_responses` integer: Number of active prompts that match `geos`, across all pages.

## Other responses

- `400`: Bad request. `error_code` is `InvalidInput` and `errors` is empty. - `from` or `to` is missing or invalid, the period is longer than 366 days, or `geos` contains an unknown value.
- `401`: Unauthorized. The credentials are missing or invalid.
- `403`: Forbidden. `error_code` is `AccessForbidden`, and `errors[0].code` names the cause: - No code (`errors` is empty): the caller can't access the site. - `AeoPlanNotFound`: the account has no active AEO plan.
- `404`: Not found. `error_code` is `ResourceNotExist`, and `errors[0].code` names the cause: - `AeoProjectNotFound`: the site has no AEO project.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)