AEO Analytics

List Prompt Executions

Lists answer engine responses to the site's prompts, newest first, with the mentions and citations in each. Covers the last 90 days unless you set a time range. Executions older than 90 days aren't listed. Results are sorted by `createdAt`, newest first. To get the next page, pass `nextCursor` as `cursor`. <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

promptIdstringOptionalformat: "objectid"

Include only executions of this prompt. Can’t be sent with topicId.

topicIdstringOptionalformat: "objectid"

Include only executions of prompts in this topic. Can’t be sent with promptId.

answerEngineenumOptional
Include only responses from this answer engine.
Allowed values:
startTimestringOptionalformat: "date-time"

Include only executions created at or after this time. Must be a UTC timestamp ending in Z. Defaults to 90 days before endTime.

endTimestringOptionalformat: "date-time"

Include only executions created before this time. Must be a UTC timestamp ending in Z. Defaults to now. The range can be at most 90 days.

includeRawResponsebooleanOptionalDefaults to false

Set to true to include each execution’s full response text in rawResponse.

limitintegerOptional1-25Defaults to 25

The maximum number of executions to return. Defaults to 25, up to 25.

cursorstringOptional

The nextCursor from the previous page.

Response

A page of prompt executions.
itemslist of objects

The prompt executions, sorted by createdAt, newest first.

nextCursorstringOptional

Pass this as cursor to get the next page. Present whenever the page is full, so the next page can be empty. Omitted on a page that isn’t full.

Errors

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