List Competitor Citations | Webflow Developer Documentation

curl -G https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/aeo/reports/competitor_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 answerEngines=chat-gpt \
     -d limit=10

{
  "report": "competitor_citations",
  "window": {
    "startTime": "2026-09-01T00:00:00Z",
    "endTime": "2026-09-08T00:00:00Z"
  },
  "competitorDomains": [
    "example.net",
    "www.example.net"
  ],
  "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": "perplexity",
        "name": "Perplexity"
      },
      "citations": [
        "https://example.net/travel",
        "https://example.org/travel/guides"
      ]
    }
  ]
}

Lists the newest responses that cited a competitor’s domain and none of your domains.

Competitor domains come from the competitors in the site’s Organization info. Results are sorted by timestamp, newest first, and aren’t paginated.

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 the newest responses that cited a competitor's domain and none of your domains. Competitor domains come from the competitors in the site's Organization info. Results are sorted by `timestamp`, newest first, and aren't paginated. <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.

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 10

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

Response

The newest responses that cited a competitor.

reportenum

The report type.

Allowed values:

windowobject

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

competitorDomainslist of strings

Your competitors’ domains, from Organization info, each with and without www..

datalist of objects

The responses that cited a competitor’s domain and none of your domains, sorted by timestamp, newest first.

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