Skip to main content
GET
List AI agents that visited 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"

Query Parameters

startDate
string

Optional. Start of the window (inclusive), YYYY-MM-DD. Omit it to get the 13 days before endDate; omit both dates for the last 14 days (UTC), matching the dashboard.

Example:

"2026-08-07"

endDate
string

Optional. End of the window (inclusive), YYYY-MM-DD. Defaults to today (UTC).

Example:

"2026-08-20"

engine
enum<string>

Optional. Restrict results to a single engine. Omit for all engines. Pass other to match every AI crawler outside the named engines.

Available options:
chatgpt,
claude,
copilot,
perplexity,
google,
other
Example:

"chatgpt"

Optional. Case-insensitive substring match on the agent name, up to 200 characters. Matched literally — % and _ are not wildcards.

Maximum string length: 200
offset
integer

Optional. Zero-based offset for pagination; must be a multiple of limit. Defaults to 0.

limit
integer

Optional. Maximum number of items to return, up to 100. Defaults to 25.

Response

A page of agents that visited the brand report.

availability
enum<string>
required

Whether these numbers can be trusted. not_connected means no logs connector is active for this report — metrics are null, NOT zero, because nothing is being measured. connected_no_data means a connector is active but matched no visits in this window, so the zeros are real. connected_with_data means the payload is populated.

Available options:
not_connected,
connected_no_data,
connected_with_data
Example:

"connected_with_data"

startDate
string
required

Start of the resolved window (inclusive), YYYY-MM-DD.

endDate
string
required

End of the resolved window (inclusive), YYYY-MM-DD.

domains
string[]
required

The report's own domains the query spanned — its main domain plus its domain variations. Normalized (lowercased, www. and port stripped).

items
object[]
required
paging
object
required
Example: