Devices

Get device, browser, or OS breakdown for a site.

Devices

Returns a breakdown of visitors by device type, browser, or operating system.

Endpoint

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

Query Parameters

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

Response fields

Returns an array of device entries:

Field	Type	Description
`name`	`string`	Device, browser, or OS name
`count`	`number`	Unique visitors using this device/browser/OS

Example request (cURL)

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

Success response (200 OK)

{
  "success": true,
  "data": [
    {
      "name": "Chrome",
      "count": 3200
    },
    {
      "name": "Safari",
      "count": 1450
    },
    {
      "name": "Firefox",
      "count": 620
    }
  ]
}