Devices, browsers, and OS endpoint

GET /api/v1/sites/{site}/devices

Returns visitor breakdown by device type, browser, and operating system with percentages.

Example request

curl -H "Authorization: Bearer your-token" "https://pageviews.ai/api/v1/sites/{site_id}/devices?from=2026-03-01&to=2026-03-07"

Response

Returns three arrays — devices, browsers, and os. Each item contains:

  • name — Device type, browser, or OS name
  • visitors — Unique visitor count
  • percentage — Percentage of total visitors (0–100)

Example response

{
  "data": {
    "devices": [
      { "name": "Desktop", "visitors": 523, "percentage": 65.4 },
      { "name": "Mobile", "visitors": 234, "percentage": 29.3 },
      { "name": "Tablet", "visitors": 42, "percentage": 5.3 }
    ],
    "browsers": [
      { "name": "Chrome", "visitors": 412, "percentage": 51.6 },
      { "name": "Safari", "visitors": 198, "percentage": 24.8 }
    ],
    "os": [
      { "name": "Windows", "visitors": 345, "percentage": 43.2 },
      { "name": "macOS", "visitors": 234, "percentage": 29.3 }
    ]
  }
}