Activate AEO for a site

post

https://api.duda.co/api/sites/multiscreen/{site_name}/aeo

Creates the site's AEO project and starts activation. Activation runs in the background and takes several minutes, so the call returns 202 Accepted with an empty body. Poll Get AEO project status until status is ACTIVATION_COMPLETED.

country_code is required and sets the project's primary market.
The site's own brand is named from brand_name, or from the site's domain when it is omitted.
brands adds up to 5 competitor brands, and cities up to 5 target cities.
New projects track ChatGPT and Gemini. Change this with Update AI models.

The site counts toward the plan's site allowance. On custom (contract) plans, it reserves one full scan per billing cycle from the plan's run pool instead.

If the site already has a project, the call returns 202 again and ignores the request body.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

202

Accepted

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

400Bad request. error_code is InvalidInput and errors is empty. country_code is missing or unsupported, or brands or cities is invalid.

401Unauthorized. The credentials are missing or invalid.

409Conflict. error_code is InvalidState, and errors[0].code names the cause: AeoActivationInProgress: another activation for this site or account is in progress. Retry later.

429Too many requests. The rate limit was exceeded.