> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Time series

> Retrieve a time-bucketed series of the core Radar metrics

Returns the core metrics bucketed over time for the project bound to your API key. The bucket
granularity is derived automatically from the requested range.

**Request:**

```bash cURL theme={null}
curl -X GET 'https://taap.it/api/v1/radar/timeseries?start=2026-01-01T00:00:00Z&end=2026-01-07T23:59:59Z' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
```

**Response:**

```json theme={null}
{
  "data": [
    {
      "t": "2026-01-01 00:00:00",
      "people": 120,
      "visits": 180,
      "pageviews": 540,
      "events": 32,
      "revenue": 210.0
    },
    {
      "t": "2026-01-02 00:00:00",
      "people": 96,
      "visits": 140,
      "pageviews": 410,
      "events": 21,
      "revenue": 0
    }
  ]
}
```

## Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token with your Radar API key. Format: `Bearer taapit_...`
</ParamField>

## Query Parameters

<ParamField query="start" type="string" required>
  Start of the range, ISO 8601 (UTC). Example: `2026-01-01T00:00:00Z`.
</ParamField>

<ParamField query="end" type="string" required>
  End of the range, ISO 8601 (UTC). Example: `2026-01-07T23:59:59Z`.
</ParamField>

## Response Fields

<ResponseField name="data" type="array" required>
  An ordered array of data points.

  <Expandable title="Data point" defaultOpen>
    <ResponseField name="t" type="string">Bucket timestamp (`YYYY-MM-DD HH:MM:SS`, UTC).</ResponseField>
    <ResponseField name="people" type="integer">Unique visitors in the bucket.</ResponseField>
    <ResponseField name="visits" type="integer">Sessions in the bucket.</ResponseField>
    <ResponseField name="pageviews" type="integer">Pageviews in the bucket.</ResponseField>
    <ResponseField name="events" type="integer">Custom events in the bucket.</ResponseField>
    <ResponseField name="revenue" type="number">Attributed revenue in the bucket.</ResponseField>
  </Expandable>
</ResponseField>