---
title: "Get site AEO usage"
method: GET
path: "/api/sites/multiscreen/{site_name}/aeo/current-usage"
tags: ["AEO Usage"]
---

# Get site AEO usage

`GET /api/sites/multiscreen/{site_name}/aeo/current-usage`

## Request

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

Returns the site's AEO usage against the plan's per-site limits. Each field except `current_refresh_run_chats` is a `used`/`limit` pair; a `limit` of `null` means no limit.

- `prompts`: active prompts across all of the site's countries. The plan's prompt limit applies to each country separately.
- `models`: tracked AI models.
- `geos`: countries with prompts, including the primary market.
- `current_refresh_run_chats`: chats a manual refresh would use now (active prompts × tracked AI models).
- `refresh_runs`: chats used by this site's manual refreshes this billing cycle, against the site's refresh limit.

The account-wide refresh allowance is in Get account AEO usage.

## Path parameters

- `site_name` string, required

## Response `200`

OK

- ApiAeoSiteUsageResp
  - `current_refresh_run_chats` integer: Chats a manual refresh would use now (active prompts × tracked models).
  - `geos` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `models` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `prompts` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `refresh_runs` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `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)