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

# Get your Radar data with the API

> The Radar API lets your own tools read your analytics: metrics, time series, realtime visitors, people, top pages and sources, and custom events.

The Radar API is the way to get your analytics out of Radar and into your own tools: a CRM, an internal dashboard, a spreadsheet, an automation. It is made for developers, so if that is not you, forward this page to the person who handles your integrations.

## What the API can read

| Data | What you get |
| - | - |
| Metrics | Your totals over a date range: people, visits, pageviews, events, revenue, sales, and more. |
| Time series | The same core metrics, split over time. |
| Realtime | The number of visitors active right now, and the list of the latest ones. |
| Breakdowns | Top pages, sources, locations, and devices. |
| People | The list of visitors, and the detail of one visitor with their sessions. |
| Custom events | Your most frequent custom events. |

The API is read-only: it reads your data and does not change anything in your project.

## Create an API key

**1. Open your project settings**

In the Radar dashboard, open the settings of the project you want to read, then go to API.

**2. Create the key and copy it**

The full key is shown only once, when you create it. Store it somewhere safe.

Each key belongs to one Radar project, so one key reads one website.

> [!WARNING]
>
> An API key gives access to your site's data. Do not share it, and never put it in the code of a public web page.

## Good to know

* **No webhooks.** Radar does not push a notification when something happens, for example when a visitor comes back. Your tool has to come and ask the API.
* **Limits.** Each key has request limits. They are listed in the API reference.
* **Plans.** API access depends on your plan. See [taap.it/pricing](https://taap.it/pricing).

## Full reference

Endpoints, parameters, and examples are in the [Radar API reference](https://docs.taap.it/api-reference/radar/introduction.md).

Not a developer and only need the numbers regularly? [Email reports](https://docs.taap.it/help/radar/features/email-reports.md) may be all you need.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.