Referrers

Get referrer source breakdown with visitor and revenue data.

Referrers

Returns a breakdown of traffic by normalized referrer domain, ranked by visitor count.

Endpoint

GET /api/v1/organizations/:orgId/sites/:siteId/analytics/referrers

Query Parameters

Parameter	Type	Required	Description
`period`	`string`	No	Time period (`day`, `7d`, `30d`, `month`, `12mo`, `custom`)
`limit`	`number`	No	Maximum number of results (default: 10)
`filters`	`string`	No	JSON-encoded filter array

Response fields

Returns an array of referrer entries:

Field	Type	Description
`referrer`	`string`	Normalized referrer domain
`visitors`	`number`	Unique visitors from this referrer

Example request (cURL)

curl -X GET \
  'https://api.engagetrack.net/api/v1/organizations/{orgId}/sites/{siteId}/analytics/referrers?period=30d&limit=10' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json'

Success response (200 OK)

{
  "success": true,
  "data": [
    {
      "referrer": "google.com",
      "visitors": 3200
    },
    {
      "referrer": "twitter.com",
      "visitors": 890
    },
    {
      "referrer": "github.com",
      "visitors": 450
    }
  ]
}