List AI agents that visited a brand report
Per-agent breakdown of AI crawler traffic, busiest agent first. category says what the agent is doing — fetching a page for a user, building a search index, or collecting training data — which is usually more actionable than the engine alone.
Authorizations
Provide your API key as a Bearer token: Authorization: Bearer YOUR_API_KEY.
Path Parameters
Brand report identifier.
1"01HX7K2YV9D3M8N0G6Q5R4S3T2"
Query Parameters
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.
"2026-08-07"
Optional. End of the window (inclusive), YYYY-MM-DD. Defaults to today (UTC).
"2026-08-20"
Optional. Restrict results to a single engine. Omit for all engines. Pass other to match every AI crawler outside the named engines.
chatgpt, claude, copilot, perplexity, google, other "chatgpt"
Optional. Case-insensitive substring match on the agent name, up to 200 characters. Matched literally — % and _ are not wildcards.
200Optional. Zero-based offset for pagination; must be a multiple of limit. Defaults to 0.
Optional. Maximum number of items to return, up to 100. Defaults to 25.
Response
A page of agents that visited the brand report.
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.
not_connected, connected_no_data, connected_with_data "connected_with_data"
Start of the resolved window (inclusive), YYYY-MM-DD.
End of the resolved window (inclusive), YYYY-MM-DD.
The report's own domains the query spanned — its main domain plus its domain variations. Normalized (lowercased, www. and port stripped).