> ## 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.

# Metrics

> Retrieve aggregate Radar metrics for a date range

Returns aggregate metrics for the project bound to your API key over the requested date range.

**Request:**

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

**Response:**

```json theme={null}
{
  "data": {
    "people": 1280,
    "visits": 1890,
    "pageviews": 5230,
    "events": 412,
    "revenue": 1990.5,
    "revenue_currency": "EUR",
    "sales": 23,
    "conversion_rate": 1.79,
    "revenue_per_visitor": 1.05,
    "bounce_rate": 38.2,
    "avg_duration_s": 142,
    "avg_duration_mmss": "02:22"
  }
}
```

## 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-31T23:59:59Z`.
</ParamField>

## Response Fields

<ResponseField name="data" type="object" required>
  <Expandable title="Metrics" defaultOpen>
    <ResponseField name="people" type="integer">Unique visitors.</ResponseField>
    <ResponseField name="visits" type="integer">Number of sessions.</ResponseField>
    <ResponseField name="pageviews" type="integer">Total pageviews.</ResponseField>
    <ResponseField name="events" type="integer">Custom events tracked.</ResponseField>
    <ResponseField name="revenue" type="number">Attributed revenue.</ResponseField>
    <ResponseField name="revenue_currency" type="string">ISO 4217 currency of `revenue`.</ResponseField>
    <ResponseField name="sales" type="integer">Number of sales / conversions.</ResponseField>
    <ResponseField name="conversion_rate" type="number">Conversion rate (percentage).</ResponseField>
    <ResponseField name="revenue_per_visitor" type="number">Revenue divided by unique visitors.</ResponseField>
    <ResponseField name="bounce_rate" type="number">Bounce rate (percentage).</ResponseField>
    <ResponseField name="avg_duration_s" type="integer">Average session duration in seconds.</ResponseField>
    <ResponseField name="avg_duration_mmss" type="string">Average session duration as `mm:ss`.</ResponseField>
  </Expandable>
</ResponseField>