List Citations
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, set offset to the previous offset plus limit. Rows can shift between pages if new responses arrive in the time range.
429 Too Many Requests. Wait for your in-flight request to finish, or for the Retry-After interval, then retry.Required scope | sites:read
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Query parameters
Inclusive 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.
Exclusive 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.
Include only these topics. Get topic IDs from List Prompts. Repeat the parameter for more than one, up to 50.
Include only these prompts. Get prompt IDs from List Prompts. Repeat the parameter for more than one, up to 50.
Include only responses from these answer engines. Repeat the parameter for more than one, such as answerEngines=chat-gpt&answerEngines=claude.
Maximum number of responses to return. Defaults to 100, up to a maximum of 1000.
Number of responses to skip. Defaults to 0.
Response
The responses, sorted by timestamp, newest first. Includes responses that cited nothing.
Whether more rows exist after this page. At limit=1000, a full page always returns true, even when the next page is empty.
The limit used.
The offset used.