Get brand visibility

get

https://api.duda.co/api/sites/multiscreen/{site_name}/aeo/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

site_name

string

required

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

Query Params

from

date

required

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

date

required

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

models

array of strings

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.

models

Allowed:

geos

array of strings

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.

geos

Responses

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad request. error_code is InvalidInput and errors is empty. from or to is missing or invalid, the period is longer than 366 days, or models or geos contains an unknown value.

401Unauthorized. The credentials are missing or invalid.

403Forbidden. 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.

404Not found. error_code is ResourceNotExist, and errors[0].code names the cause: AeoProjectNotFound: the site has no AEO project.

429Too many requests. The rate limit was exceeded.