API
AI Crawler Events Resource
Export daily AI crawler visits captured from your tracked sites.
Daily counts of AI crawler visits (GPTBot, ClaudeBot, PerplexityBot, Bingbot, Amazonbot, and more) recorded from sites where you installed crawler tracking. Each row is one day's hit total for a single crawler on a single path.
Endpoint:
GET /api/v1/crawler-eventsThis resource is only populated once you install crawler tracking on a site (AI Crawlers → Install tracking). See AI Crawler Tracking for setup.
Filters
| Filter | Meaning |
|---|---|
crawler_id | Restrict to one crawler, e.g. gptbot, claudebot, perplexitybot, bingbot. |
site_key_id | Restrict to one tracked site. |
since | Lower bound for event_date (ISO date). |
until | Upper bound for event_date (ISO date). |
Key fields
site_key_id— the tracked site the visit was recorded forevent_date— UTC day of the visits (YYYY-MM-DD)crawler_id— stable crawler identifier (e.g.gptbot)crawler_org— operating company (e.g.OpenAI)path— the request path the crawler hithits— number of visits that day for this crawler + path
Example
curl -H "Authorization: Bearer $AEO_API_KEY" \
"https://app.citlyze.com/api/v1/crawler-events?crawler_id=gptbot&since=2026-06-01"CSV export is supported with ?format=csv. Rows are ordered by event_date
(newest first); paginate with limit and offset.
Use this resource to chart AI crawler traffic over time, attribute visits to specific pages, and compare which engines crawl you most.