List Citations

GET

https://api.webflow.com/beta/sites/:site_id/aeo/reports/citations

GET

/beta/sites/:site_id/aeo/reports/citations

curl -G https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/reports/citations \
     -H "Authorization: Bearer <token>" \
     --data-urlencode startTime=2026-09-01T00:00:00Z \
     --data-urlencode endTime=2026-09-08T00:00:00Z \
     -d topicIds=68cdb4b5a699862fcd8c1a02 \
     -d promptIds=68cdb4b5a699862fcd8c1a01 \
     -d answerEngines=chat-gpt \
     -d limit=100 \
     -d offset=0

{
  "report": "citations",
  "window": {
    "startTime": "2026-09-01T00:00:00Z",
    "endTime": "2026-09-08T00:00:00Z"
  },
  "data": [
    {
      "timestamp": "2026-09-07T06:00:12.000Z",
      "topic": {
        "id": "68cdb4b5a699862fcd8c1a02",
        "name": "Galactic travel"
      },
      "prompt": {
        "id": "68cdb4b5a699862fcd8c1a01",
        "text": "What's the best guide for traveling the galaxy?"
      },
      "answerEngine": {
        "key": "chat-gpt",
        "name": "ChatGPT"
      },
      "citations": [
        "https://example.com/guides/dont-panic"
      ],
      "citationDomains": [
        "example.com"
      ],
      "citationPaths": [
        "/guides/dont-panic"
      ],
      "mentions": [
        "Hitchhiker's Guide"
      ]
    }
  ],
  "hasMore": true,
  "limit": 100,
  "offset": 0
}

Lists answer engine responses over a time range, newest first, with every citation and mention in each.

Includes responses that cited nothing. To get the next page, add limit to offset. Rows can shift between pages if new responses arrive in the time range.

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.

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.

Required scope | sites:read

Lists answer engine responses over a time range, newest first, with every citation and mention in each. Includes responses that cited nothing. To get the next page, add `limit` to `offset`. Rows can shift between pages if new responses arrive in the time range. <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.

topicIdslist of stringsOptional

Include only these topics. Get topic IDs from List Prompts. Repeat the parameter for more than one, up to 50.

promptIdslist of stringsOptional

Include only these prompts. Get prompt IDs from List Prompts. Repeat the parameter for more than one, up to 50.

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:

limitintegerOptional1-1000Defaults to 100

The maximum number of responses to return. Defaults to 100, up to 1000.

offsetintegerOptional>=0Defaults to 0

The number of responses to skip. Defaults to 0.

Response

A page of responses with their citations.

reportenum

The report type.

Allowed values:

windowobject

The time range of the report, echoed exactly as sent.

datalist of objects

The responses, sorted by timestamp, newest first. Includes responses that cited nothing.

hasMoreboolean

Whether more rows exist after this page. At limit=1000, a full page always returns true, even when the next page is empty.

limitinteger

The limit used.

offsetinteger

The offset used.

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