Get AEO recommendations

get

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

Returns recommendations for improving the site's visibility in AI answers, sorted by impact (HIGH, then MEDIUM, then LOW). Recommendations always cover the last 30 days up to today (UTC); there are no date parameters.

type=on-site returns changes to make on the site itself, such as blog posts or page updates. It requires the site's Blog or SEO permission and at least one competitor brand with a domain.
type=off-site returns up to 10 opportunities on third-party sites, such as listicles, comparisons or community sites. counts covers only the returned items.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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. type is missing or isn't on-site or off-site.

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. No code (errors is empty): type=on-site and the caller lacks the site's Blog or SEO permission. 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.

422Unprocessable entity. error_code is InvalidState, and errors[0].code names the cause: AeoCompetitorDomainRequired: type=on-site and no competitor brand has a domain. Add one with Add a competitor brand.

429Too many requests. The rate limit was exceeded.