Skip to main content
GET
/
api
/
v1
/
radar
/
breakdowns
Breakdowns
curl --request GET \
  --url https://taap.it/api/v1/radar/breakdowns \
  --header 'Authorization: <authorization>'
{
  "data": {
    "pages.top": [
      {}
    ],
    "sources.referrer": [
      {}
    ],
    "locations.countries": [
      {}
    ],
    "devices.browsers": [
      {}
    ],
    "devices.os": [
      {}
    ],
    "events": [
      {}
    ],
    "hostnames": [
      {}
    ]
  }
}
Returns the top breakdowns (pages, sources, locations and devices) for the project bound to your API key over the requested date range. Request:
cURL
curl -X GET 'https://taap.it/api/v1/radar/breakdowns?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=20' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Response: 
{
  "data": {
    "pages": {
      "top": [
        { "pathname": "/", "people": 320 },
        { "pathname": "/pricing", "people": 110 }
      ]
    },
    "sources": {
      "referrer": [
        { "name": "Direct", "people": 210 },
        { "name": "Google", "people": 180 }
      ]
    },
    "locations": {
      "countries": [
        { "name": "France", "people": 240, "countryCode": "FR", "revenue": 980.0 },
        { "name": "Belgium", "people": 90, "countryCode": "BE", "revenue": 120.0 }
      ]
    },
    "devices": {
      "browsers": [
        { "name": "Chrome", "people": 410 },
        { "name": "Safari", "people": 220 }
      ],
      "os": [
        { "name": "Windows", "people": 300 },
        { "name": "iOS", "people": 180 }
      ]
    },
    "events": [
      { "event_name": "signup_click", "people": 40, "events": 52, "completion_rate": 0 }
    ],
    "hostnames": ["www.example.com"]
  }
}

​
Authorization

​
Authorization
string
required
Bearer token with your Radar API key. Format: Bearer taapit_...

​
Query Parameters

​
start
string
required
Start of the range, ISO 8601 (UTC). Example: 2026-01-01T00:00:00Z.
​
end
string
required
End of the range, ISO 8601 (UTC). Example: 2026-01-31T23:59:59Z.
​
limit
integer
default:"50"
Maximum number of rows per breakdown. Must be a positive number. Defaults to 50.

​
Response Fields

​
data
object
required
Each section is optional and omitted when there is no data.