Get AI agent traffic overview for a brand report
Overview of AI crawler and agent traffic across the brand report’s own domains: total visits, distinct pages visited, the busiest engine, per-engine totals, and a daily trend with each engine’s share. Check availability before rendering — not_connected means no logs connector is set up and the metrics are null, not zero.
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"
Response
Agent traffic overview for 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).
Total AI agent visits in the window. null when availability is not_connected.
x >= 0Distinct pages visited in the window. null when availability is not_connected.
x >= 0Engine with the most visits in the window; null when there were none.
chatgpt, claude, copilot, perplexity, google, other, null "chatgpt"
Window totals per engine, highest first. Empty when there is no data.
Per-(day, engine, bot) visit series for the window. engine is the folded public id (same vocabulary as engines/topEngine); bot is the raw crawler name, so one engine can span several bots on a day.