# Visitors who agreed, last seen first

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-visitors

`GET /api/v1/sites/{site}/visitors`

Visitors who agreed, last seen first.

## Parameters

- `site` (in path, needed): A site's id or name
- `period` (in query): 30d when left out
- `min_visits` (in query): Only visitors with this many visits
- `find` (in query): A visitor ID or the site's own user ID
- `limit` (in query): 25 when left out
- `offset` (in query): How many to skip

## The answer

200, `VisitorsResponse`

- `came_back` (integer, needed)
- `coverage` (Coverage, needed)
- `days_between` (number or null): Median days between one visit and the next.
- `keep_days` (integer, needed): How long a visitor is remembered: the site's setting.
- `period` (PeriodView, needed)
- `rows` (list of VisitorRow, needed)
- `signed_in` (integer, needed)
- `site` (string, needed)
- `total` (integer, needed): How many match in all.
- `visits_mean` (number or null)
- `visits_median` (number or null)
- `weeks` (list of WeekCount, needed)

## Asking

```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/visitors \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```