AI Referral Conversions
Daily conversion events attributed to the AI source that referred the visitor.
GET /api/v1/ai-referral-conversions returns daily counts of conversion
events completed by visitors who arrived from an AI answer, attributed to
the referring source in the same session. Visits themselves are in
AI referrals; this resource covers the events you
configured in the AI Traffic capture settings (for example signup).
Filters
| Parameter | Meaning |
|---|---|
source_id | Restrict to one AI source (e.g. referral_chatgpt). |
site_key_id | Restrict to one tracked site. |
event_name | Restrict to one conversion event. |
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 conversion was recorded forevent_date: UTC day of the conversions (YYYY-MM-DD)source_id: the AI source that referred the converting sessionevent_name: the conversion event, as configured in capture settingslanding_path: the session's entry page, not the page where the event firedhits: number of conversions that day for this combinationlast_seen_at: timestamp of the most recent conversion counted
Rows are ordered by event_date descending, so offset pagination is
stable. Like AI referrals, rows are served within your plan's referral
history window.
Example
curl -H "Authorization: Bearer $AEO_API_KEY" \
"https://app.citlyze.com/api/v1/ai-referral-conversions?event_name=signup&since=2026-08-01"Use this resource to report which AI assistants refer visitors who actually convert, and which landing pages start those sessions.