Get Recommendation

GET

https://api.webflow.com/beta/sites/:site_id/aeo/recommendations/:recommendation_id

GET

/beta/sites/:site_id/aeo/recommendations/:recommendation_id

curl https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations/68b1b1b1b1b1b1b1b1b1b1b1 \
     -H "Authorization: Bearer <token>"

{
  "id": "68b1b1b1b1b1b1b1b1b1b1b1",
  "rule": "page_title_required",
  "status": "active",
  "priority": "high",
  "topic": "metadata",
  "type": "gap",
  "target": {
    "kind": "page",
    "pageId": "580e63e98c9a982ac9b8b745"
  },
  "proposal": {
    "kind": "page_title",
    "seoTitle": "A better title",
    "currentValue": "Old title"
  },
  "audit": {
    "id": "68b0a0a0a0a0a0a0a0a0a0a0",
    "runOn": "2026-08-01T10:00:00.000Z"
  },
  "createdOn": "2026-08-02T11:00:00.000Z",
  "updatedOn": "2026-08-03T12:00:00.000Z",
  "evidence": "The page has no title.",
  "action": "Add a title."
}

Returns a single AEO recommendation for the site. Missing recommendations, cross-site ids, and malformed ids all return 404 aeo_recommendation_not_found so existence is not revealed across sites.

AEO recommendations entitlement required

This endpoint requires a workspace with the AEO recommendations entitlement.

Required scope | sites:read

Returns a single AEO recommendation for the site. Missing recommendations, cross-site ids, and malformed ids all return `404 aeo_recommendation_not_found` so existence is not revealed across sites. <Warning title="AEO recommendations entitlement required">This endpoint requires a workspace with the AEO recommendations entitlement.</Warning> Required scope | `sites:read`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

recommendation_idstringRequiredformat: "objectid"

Unique identifier for an AEO recommendation

Response

A single recommendation

idstringformat: "objectid"

Recommendation id.

ruleenum

Recommendation rule that produced the diagnosis.

statusenum

Public lifecycle status. Internal pending and in_progress both map to generating.

priorityenum

Recommendation priority.

topicenum

Recommendation topic.

typeenum

Whether the recommendation closes a gap or surfaces an opportunity.

targetobject or null

Discriminated target for the recommendation. null when stored fields cannot be mapped to exactly one target family.

proposalobject or null

Typed suggested fix. null while the recommendation is still generating, failed, or the stored proposal cannot be parsed.

auditobject

Audit run that produced the recommendation.

createdOnstringformat: "date-time"

updatedOnstringformat: "date-time"

evidencestringOptional

Human-readable evidence for the diagnosis.

actionstringOptional

Suggested next action in plain language.

localeIdstringOptionalformat: "objectid"

Locale the recommendation belongs to, when localized.

actionedAtstringOptionalformat: "date-time"

When the recommendation entered a terminal actioned state.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error