Skip to main content
GET
List AI responses for a prompt in a brand report.

Authorizations

Authorization
string
header
required

Provide your API key as a Bearer token: Authorization: Bearer YOUR_API_KEY.

Path Parameters

reportId
string
required

Brand report identifier.

Minimum string length: 1
Example:

"01HX7K2YV9D3M8N0G6Q5R4S3T2"

promptId
string
required

Prompt identifier within the brand report.

Minimum string length: 1
Example:

"01HX7K2YV9D3M8N0G6Q5R4S3T2"

Query Parameters

startDate
string
required

Start date for the lookup window (inclusive). Accepts YYYY-MM-DD or a full ISO timestamp; only the date portion is used and the window is anchored at 00:00:00.000Z.

Minimum string length: 1
Example:

"2025-01-01"

endDate
string
required

End date for the lookup window (inclusive). Accepts YYYY-MM-DD or a full ISO timestamp; only the date portion is used and the window is anchored at 23:59:59.999Z.

Minimum string length: 1
Example:

"2025-01-31"

country
string
required

Country code to filter by. Lowercase ISO 3166-1 alpha-2; use uk for the United Kingdom.

Minimum string length: 1
Example:

"us"

engine
enum<string>

Optional. Filter results to a single AI engine.

Available options:
chatgpt,
google,
perplexity,
copilot,
google_ai_mode,
gemini,
claude
Example:

"chatgpt"

cursor
string

Optional. Pagination cursor — pass back the nextCursor value from a previous response. Omit to fetch the first page.

Minimum string length: 1

Response

AI responses (jobs) collected for the prompt within the window.

items
object[]
required
paging
object
required
Example: