DUduda
AEO Analytics

Get site AEO report

Returns a combined AEO report for the site over the requested period: brand visibility, tracked prompt performance, a sample of answers and, optionally, recommendations. The parameters and response match Get AEO report, applied to the site's own project. Reading it uses no report allowance.

  • visibility.brands holds the own brand plus up to brands competitors.
  • answers holds the newest answer for each of the top chats tracked prompts, per selected model.
  • With include_recommendations=true, on_site_recommendations and off_site_recommendations are filled in. Otherwise they are null.
get/api/sites/multiscreen/{site_name}/aeo/report

Request

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

brandsstring

Number of competitor brands to include in visibility.brands, besides the own brand, which is always included. Competitors are picked by visibility, highest first. 0 returns only the own brand.

chatsstring

Number of top tracked prompts to sample answers from. The newest answer per prompt per selected model is returned.

modelsApiAeoModel[]

Only include these AI models in the statistics and sampled answers. Send a comma-separated list or repeat the parameter, up to 10 values. 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.

include_recommendationsboolean

Whether to fill in on_site_recommendations and off_site_recommendations. When false, both are null.

Response

OK

Changes

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