AI Referrals
Daily human visits that arrived from AI answers, by source and landing page.
GET /api/v1/ai-referrals returns daily counts of human visitors who
clicked through to your site from an AI answer (ChatGPT, Perplexity, Gemini,
Copilot, Claude, and others). The data comes from the same tracking install
as crawler events; the endpoint returns rows
once your install has delivered referral events.
Filters
| Parameter | Meaning |
|---|---|
source_id | Restrict to one AI source (e.g. referral_chatgpt). |
site_key_id | Restrict to one tracked site. |
path | Restrict to one landing path (exact match). |
since / until | Bounds for event_date (ISO date). |
Standard parameters (limit, offset, format=csv) work as described in
Pagination, filtering, and errors.
Key fields
site_key_id: the tracked site the visit was recorded forevent_date: UTC day of the visits (YYYY-MM-DD)source_id: stable AI source identifier (e.g.referral_chatgpt)source_org: the organization behind the source (e.g.OpenAI)path: the landing path the visitor arrived onhits: number of visits that day for this source + pathlast_seen_at: timestamp of the most recent visit counted in this row
Rows are ordered by event_date descending, so offset pagination is stable.
Example
curl -H "Authorization: Bearer $AEO_API_KEY" \
"https://app.citlyze.com/api/v1/ai-referrals?source_id=referral_chatgpt&since=2026-06-01"Use this resource to see which AI assistants actually send you visitors, which pages they land on, and how referral traffic trends over time.