DUduda
AEO Analytics

Get brand visibility

Returns how visible the site's brand and its competitors are in AI answers, aggregated over the requested period, plus the source domains the answer engines cite most.

  • brands lists up to 10 brands: the site's own brand first, then competitors by visibility.
  • source_mentions lists up to 10 domains: the own brand's domains first, then by share.
get/api/sites/multiscreen/{site_name}/aeo/visibility

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/aeo/visibility
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

Query parameters

fromstring date required
Example:2026-07-01

First day of the period, inclusive, as an ISO 8601 date (YYYY-MM-DD, UTC). The period can span at most 366 days.

tostring date required
Example:2026-07-31

Last day of the period, inclusive, as an ISO 8601 date (YYYY-MM-DD, UTC). Must not be before from.

modelsApiAeoModel[]

Only include these AI models. Send a comma-separated list or repeat the parameter. Case-insensitive. Unknown values return 400. Omit to include every model.

geosstring[]

Only include prompts in these countries, as ISO 3166-1 alpha-2 codes (e.g. US). Send a comma-separated list or repeat the parameter. Case-insensitive. Unsupported codes return 400. Omit to include every country.

Response

OK

fromstring date

First day of the period (UTC).

tostring date

Last day of the period (UTC).

total_chatsinteger

Answers recorded in the period, across all AI models.

total_chats_by_llmobject

Answers recorded in the period, per AI model. Keys are AI model values such as CHAT_GPT.

total_mentionsinteger

Brand mentions across all answers in the period, summed over every brand.

Changes

No recorded changes to this operation across all 1 revision of this API.