AEO Analytics

Get Page Citation Share

Returns one page's share of all citations to your domains, optionally broken down by prompt. For a CMS item, send `collectionId` and `itemSlug` along with `pageId`. With `breakdown=prompt`, returns each prompt's share of this page's citations, sorted by `citationShare`, highest first. <Warning title="AEO analytics entitlement required">This endpoint requires a site or workspace with the AEO analytics entitlement, and Webflow AI must be enabled for the workspace.</Warning> <Note title="Concurrency limit: 1 request at a time">Each access token can have one AEO request in flight at a time, across all AEO Analytics endpoints. Additional concurrent requests return `429 Too Many Requests`; wait for your in-flight request to finish, or for the `Retry-After` interval, then retry.</Note> 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

Query parameters

startTimestringRequiredformat: "date-time"

Start of the time range. Must be a UTC timestamp ending in Z, such as 2026-09-01T00:00:00Z; offsets and date-only values aren’t accepted. Seconds and milliseconds are optional.

endTimestringRequiredformat: "date-time"

End of the time range. Must be a UTC timestamp ending in Z, and later than startTime. The range can be at most 100 days.

pageIdstringRequiredformat: "objectid"
The page ID. For a CMS item, the ID of its template page.
collectionIdstringOptionalformat: "objectid"

The CMS collection ID, for a CMS item. Send it with itemSlug.

itemSlugstringOptional>=1 character

The CMS item’s slug, for a CMS item. Send it with collectionId.

breakdownenumOptional

Set to prompt to return one row per prompt that cited the page.

Allowed values:
answerEngineslist of enumsOptional

Include only responses from these answer engines. Repeat the parameter for more than one, such as answerEngines=chat-gpt&answerEngines=claude.

Allowed values:

Response

The page's citation share.
reportenum
The report type.
Allowed values:
windowobject
The time range of the report, echoed exactly as sent.
pageobject

The page, as sent. title is present only when the page is on this site and its title can be found.

datalist of objects

One row for the page, or one row per prompt when breakdown=prompt, sorted by citationShare, highest first.

breakdownenumOptional

Present only when breakdown was sent.

Allowed values:
filterobjectOptional
The filters the report used. Present only when a filter was sent.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error