Skip to main content
GET
/
api
/
v1
/
radar
/
people
People
curl --request GET \
  --url https://taap.it/api/v1/radar/people \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "visitorId": "<string>",
      "name": "<string>",
      "email": {},
      "status": "<string>",
      "countryCode": "<string>",
      "countryName": "<string>",
      "source": "<string>",
      "browser": "<string>",
      "device": "<string>",
      "revenue": 123,
      "sessions": 123,
      "events": 123,
      "firstSeen": "<string>",
      "lastSeen": "<string>"
    }
  ],
  "total": 123,
  "limit": 123
}
Returns a paginated list of people (visitors) over the requested date range, with their key attributes (identity, location, source, device, revenue, sessions). Supports optional filters. Request:
cURL
curl -X GET 'https://taap.it/api/v1/radar/people?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=50&sort=recent' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Response: 
{
  "data": [
    {
      "visitorId": "v_8a1c2d",
      "name": "Quiet Fox",
      "email": "jane@example.com",
      "status": "identified",
      "countryCode": "FR",
      "countryName": "France",
      "source": "google",
      "browser": "Chrome",
      "device": "desktop",
      "revenue": 120.0,
      "sessions": 4,
      "events": 37,
      "firstSeen": "2026-01-03T09:12:00.000Z",
      "lastSeen": "2026-01-28T17:42:00.000Z"
    }
  ],
  "total": 1842,
  "limit": 50
}

​
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.
​
sort
string
default:"recent"
Sort order. recent (last activity), revenue, sessions or events.
​
limit
integer
default:"200"
Maximum number of people to return. Capped at 1000.
​
country
string
Filter by ISO-2 country code (e.g. FR).
​
browser
string
Filter by browser name (e.g. Chrome).
​
device
string
Filter by device type (desktop, mobile, tablet).
​
referrer
string
Filter by traffic source / referrer.
​
identity
string
Filter by identity status (identified or anonymous).
​
activity
string
Filter by activity level.

​
Response Fields

​
data
array
required
Array of people.
​
total
integer
Total number of people in the range (unfiltered). Equals data.length when filters are applied.
​
limit
integer
The effective limit applied to this response.