Metrics

Get AI referral traffic

Markdown
GET
/v1/brands/{brandId}/traffic

Visits, key events and revenue that came from AI assistants, per day and source, imported from the brand's Google Analytics 4 property. Empty until Google Analytics is connected in the app.

Authorization

bearer
AuthorizationBearer <token>

An API key from Settings → API keys in the Gensiv app.

In: header

Path Parameters

brandId*string

A brand id from GET /v1/brands.

Formatuuid

Query Parameters

from?string

First day to include, in the GA4 property's time zone (YYYY-MM-DD). Defaults to 29 days before to.

to?string

Last day to include, in the GA4 property's time zone (YYYY-MM-DD). Defaults to today.

source?string

Only include visits referred by this AI assistant.

Value in

  • "chatgpt"
  • "perplexity"
  • "gemini"
  • "claude"
  • "copilot"
  • "other-ai"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/traffic"
{  "from": "2026-09-01",  "to": "2026-09-30",  "connected": true,  "property": "acme.com – GA4",  "currency": "USD",  "totals": {    "aiSessions": 1284,    "keyEvents": 63,    "revenue": 4100,    "siteSessions": 61210,    "shareOfSite": 2.1  },  "data": [    {      "date": "2026-09-14",      "source": "chatgpt",      "sessions": 42,      "engagedSessions": 31,      "newUsers": 28,      "keyEvents": 3,      "revenue": 120.5    }  ]}