> This page is for Data API, version v2 Beta. > For other versions, use one of these documentation indexes: > - v2 (default): https://developers.webflow.com/data/v2.0.0/llms.txt > - v2 Beta: https://developers.webflow.com/data/v2.0.0-beta/llms.txt > - v1: https://developers.webflow.com/data/v1.0.0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.webflow.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server. # List Recommendations GET https://api.webflow.com/beta/sites/{site_id}/aeo/recommendations Lists a site's AEO recommendations, newest first, with cursor pagination.Repeatable filters (`status`, `rule`, `priority`, `topic`) accept a single value or multiple values via repeated query keys (`status=active&status=dismissed`). Unsupported query parameters return `400 validation_error`.This endpoint requires a workspace with the AEO recommendations entitlement.Required scope | `sites:read` Reference: https://developers.webflow.com/data/v2.0.0-beta/reference/aeo-recommendations/list ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `site_id` (string, required) — Unique identifier for a Site ### Query parameters - `status` (list of enum, optional) — Filter by public status. Repeat the parameter to match any of several statuses. - Allowed values: `generating`, `active`, `applied`, `dismissed`, `stale`, `failed` - `rule` (list of enum, optional) — Filter by recommendation rule. Repeat the parameter to match any of several rules. - Allowed values: `asset_alt_text_required`, `page_title_required`, `page_title_length_invalid`, `page_title_stale`, `page_description_required`, `page_description_length_invalid`, `page_description_stale`, `page_schema_required`, `page_schema_stale`, `broken_link`, `item_recommendation` - `priority` (list of enum, optional) — Filter by priority. Repeat the parameter to match any of several priorities. - Allowed values: `low`, `medium`, `high`, `critical` - `topic` (list of enum, optional) — Filter by topic. Repeat the parameter to match any of several topics. - Allowed values: `metadata`, `schema`, `page`, `component`, `cms`, `asset` - `pageId` (string, optional) — Filter to recommendations that target this page. - `localeId` (string, optional) — Filter to recommendations for this locale. When the id is the site's primary locale, rows with no `localeId` are included as well. - `limit` (integer, optional, default: 50) — Maximum number of recommendations to return. Defaults to `50`, up to `100`. - `cursor` (string, optional) — Opaque pagination cursor from a previous response's `nextCursor`. ## Response ### 200 Paginated list of recommendations - `items` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItems, required) - `nextCursor` (string, optional) — Opaque cursor for the next page. Omit when there are no more results. ## Errors ### 400 Bad Request Error The request was rejected by AEO recommendations validation. The `code` field on the response identifies which rule failed: * `validation_error` — a query parameter or request body field failed validation, or an unrecognized key was supplied. The `details` array lists each failure as `{ param, description }`. - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ### 401 Unauthorized Error Provided access token is invalid or does not have access to requested resource - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ### 403 Forbidden Error The access token is missing the required scope, or the site's workspace does not have the AEO recommendations entitlement. - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ### 404 Not Found Error Requested resource not found - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ### 429 Too Many Requests Error The rate limit of the provided access_token has been reached. Please have your application respect the X-RateLimit-Remaining header we include on API responses. - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ### 500 Internal Server Error We had a problem with our server. Try again later. - `code` (enum, optional) — Error code - Allowed values: `aeo_input_validation`, `analyze_filter_conflict`, `analyze_input_validation`, `analyze_unsupported_filter`, `bad_request`, `batch_too_large`, `before_historical_floor`, `billing_provider_unavailable`, `branch_merge_conflict`, `branch_merge_in_progress`, `branch_not_found`, `branch_publish_failed`, `branch_sync_pending`, `branch_task_not_found`, `branch_update_in_progress`, `brand_not_configured`, `cannot_invite_self`, `cannot_remove_self`, `cannot_update_user_role`, `client_seats_unavailable`, `collection_not_found`, `competitors_not_configured`, `conflict`, `conflicting_scope_filters`, `default_site_role_required`, `duplicate_collection`, `duplicate_member_in_request`, `duplicate_site_in_request`, `duplicate_user_email`, `ecommerce_not_enabled`, `end_time_too_recent`, `enterprise_provisioning_upstream_error`, `enterprise_self_provisioning_not_entitled`, `forbidden`, `forms_require_republish`, `incompatible_webhook_filter`, `insufficient_permissions`, `insufficient_seats`, `internal_error`, `invalid_auth_version`, `invalid_credentials`, `invalid_domain`, `invalid_resolution`, `invalid_site_role`, `invalid_time_range`, `invalid_user_email`, `invalid_workspace_role`, `invite_expired`, `invite_role_conflict`, `item_not_found`, `managed_by_scim`, `member_already_has_access`, `member_has_no_site_access`, `member_is_paying_client`, `member_not_found`, `member_not_removable`, `member_role_conflict`, `missing_scopes`, `no_domains`, `no_members_or_invites`, `not_authorized`, `not_enterprise_plan_site`, `not_enterprise_plan_workspace`, `optimize_before_historical_floor`, `optimize_input_validation`, `optimize_invalid_interval`, `optimize_unknown_dimension`, `optimize_unknown_goal`, `optimize_unknown_optimization`, `optimize_unsupported_group_by`, `order_not_found`, `page_cannot_branch`, `resource_not_found`, `service_unavailable`, `site_access_not_applicable_to_member`, `site_access_not_scopable_for_role`, `site_access_roles_must_match`, `site_not_in_workspace`, `site_role_id_invalid`, `site_role_id_not_allowed`, `site_role_id_required`, `site_specific_access_disabled`, `site_specific_access_not_entitled`, `time_range_too_wide`, `too_many_requests`, `unsupported_bot_provider`, `unsupported_version`, `unsupported_webhook_trigger_type`, `user_limit_reached`, `user_not_found`, `users_not_enabled`, `validation_error`, `workspace_invite_not_found`, `workspace_member_managed_by_scim`, `workspace_member_not_found`, `workspace_member_not_removable`, `workspace_role_not_grantable` - `message` (string, optional) — Error message - `externalReference` (string, optional) — Link to more information - `details` (list of SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems, optional) — Array of errors ## Types ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItems Public shape of an AEO recommendation. - `id` (string, required) — Recommendation id. - `rule` (enum, required) — Recommendation rule that produced the diagnosis. - Allowed values: `asset_alt_text_required`, `page_title_required`, `page_title_length_invalid`, `page_title_stale`, `page_description_required`, `page_description_length_invalid`, `page_description_stale`, `page_schema_required`, `page_schema_stale`, `broken_link`, `item_recommendation` - `status` (enum, required) — Public lifecycle status. Internal `pending` and `in_progress` both map to `generating`. - Allowed values: `generating`, `active`, `applied`, `dismissed`, `stale`, `failed` - `priority` (enum, required) — Recommendation priority. - Allowed values: `low`, `medium`, `high`, `critical` - `topic` (enum, required) — Recommendation topic. - Allowed values: `metadata`, `schema`, `page`, `component`, `cms`, `asset` - `type` (enum, required) — Whether the recommendation closes a gap or surfaces an opportunity. - Allowed values: `gap`, `opportunity` - `target` (SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsTarget, required, nullable) — Discriminated target for the recommendation. `null` when stored fields cannot be mapped to exactly one target family. - `proposal` (SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal, required, nullable) — Typed suggested fix. `null` while the recommendation is still generating, failed, or the stored proposal cannot be parsed. - `audit` (SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsAudit, required) — Audit run that produced the recommendation. - `createdOn` (string, required) - `updatedOn` (string, required) - `evidence` (string, optional) — Human-readable evidence for the diagnosis. - `action` (string, optional) — Suggested next action in plain language. - `localeId` (string, optional) — Locale the recommendation belongs to, when localized. - `actionedAt` (string, optional) — When the recommendation entered a terminal actioned state. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaDetailsItems ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsTarget Discriminated target for the recommendation. `null` when stored fields cannot be mapped to exactly one target family. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal Typed suggested fix. `null` while the recommendation is still generating, failed, or the stored proposal cannot be parsed. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsAudit Audit run that produced the recommendation. - `id` (string, required) — Audit identifier. - `runOn` (string, optional) — When the audit ran. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsTarget0 - `kind` (enum, required) - Allowed values: `page` - `pageId` (string, required) — Page the recommendation targets. - `elementId` (string, optional) — Optional element within the page. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsTarget1 - `kind` (enum, required) - Allowed values: `asset` - `assetId` (string, required) — Asset the recommendation targets. - `assetUrl` (string, optional) — Optional published URL for the asset. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsTarget2 - `kind` (enum, required) - Allowed values: `cms_item` - `collectionId` (string, required) — CMS collection that owns the item. - `itemId` (string, optional) — Optional CMS item id. - `fieldSlug` (string, optional) — Optional field slug within the item. - `pageId` (string, optional) — Optional collection page tied to the item. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal0 - `kind` (enum, required) - Allowed values: `page_title` - `seoTitle` (string, required) — Suggested SEO title. - `currentValue` (string, optional) — Current SEO title, when known. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal1 - `kind` (enum, required) - Allowed values: `page_description` - `seoDesc` (string, required) — Suggested SEO description. - `currentValue` (string, optional) — Current SEO description, when known. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal2 - `kind` (enum, required) - Allowed values: `page_schema` - `jsonLdSchema` (map from string to any, required) — Suggested JSON-LD object. Must contain at least one property. - `currentMarkup` (string, optional) — Current script-wrapped markup on the page, when known. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal3 - `kind` (enum, required) - Allowed values: `asset_alt_text` - `altText` (string, required) — Suggested alt text for the asset. ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal4 Diagnosis only. Applying a `broken_link` recommendation requires a separate `linkTarget` on the apply endpoint (not part of the M2 read surface). - `kind` (enum, required) - Allowed values: `broken_link` - `errorType` (enum, required) — Why the link failed validation. - Allowed values: `page_archived`, `page_not_published`, `page_not_found`, `invalid_dynpage_slug` ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposal5 - `kind` (enum, required) - Allowed values: `content_brief` - `topicLabel` (string, optional) — Topic discovered for the content opportunity. - `citations` (list of string, optional) — Supporting citation URLs. - `brief` (SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposalOneOf5Brief, optional) ### SitesSiteIdAeoRecommendationsGetResponsesContentApplicationJsonSchemaItemsItemsProposalOneOf5Brief - `content` (string, required) — Editable brief content. - `userEdited` (boolean, optional) — Whether a caller edited the brief after generation. - `editedAt` (string, optional) — When the brief was last edited by a caller. ## Examples **Response** ```json { "items": [ { "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" }, "audit": { "id": "68b0a0a0a0a0a0a0a0a0a0a0", "runOn": "2026-08-01T10:00:00.000Z" }, "createdOn": "2026-08-02T11:00:00.000Z", "updatedOn": "2026-08-03T12:00:00.000Z" } ], "nextCursor": "opaque-next-page" } ``` **SDK Code** ```python RecommendationList import requests url = "https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations" querystring = {"status":"[\"active\",\"dismissed\"]","rule":"[\"page_title_required\"]","priority":"[\"high\"]","topic":"[\"metadata\"]","pageId":"580e63e98c9a982ac9b8b745","localeId":"68b2c2c2c2c2c2c2c2c2c2c2","limit":"50","cursor":"opaque-next-page"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript RecommendationList const url = 'https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go RecommendationList package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby RecommendationList require 'uri' require 'net/http' url = URI("https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java RecommendationList import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page") .header("Authorization", "Bearer ") .asString(); ``` ```php RecommendationList request('GET', 'https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp RecommendationList using RestSharp; var client = new RestClient("https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift RecommendationList import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/recommendations?status=%5B%22active%22%2C%22dismissed%22%5D&rule=%5B%22page_title_required%22%5D&priority=%5B%22high%22%5D&topic=%5B%22metadata%22%5D&pageId=580e63e98c9a982ac9b8b745&localeId=68b2c2c2c2c2c2c2c2c2c2c2&limit=50&cursor=opaque-next-page")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```