Series

GET /api/v1/sites/:id/series

One point per bucket for the whole range, zero-filled, so a quiet day is a zero and not a missing key.

Parameters

Parameter	Values	Default
`range`	the nine range keys	`30d`
any filter key		none

The bucket size is chosen by the range and cannot be set directly:

Range	`unit`
`today`, `yesterday`, `24h`	`hour`
`7d`, `30d`, `90d`, `week`, `month`	`day`
`12m`	`month`

Request

curl -s -H "Authorization: Bearer tk_live_…" \
  "https://tracing.tools/api/v1/sites/pk_live_a91c3f04/series?range=7d"

Response

{
  "unit": "day",
  "timezone": "Europe/Berlin",
  "data": [
    {
      "date": "2026-09-10T00:00:00",
      "Visitors": 612,
      "Pageviews": 1504,
      "Sessions": 780,
      "RevenueCents": 24900,
      "BounceRate": 55.128205128205124,
      "AvgVisitMs": 84210.5,
      "ViewsPerVisit": 1.928205128205128
    },
    {
      "date": "2026-09-11T00:00:00",
      "Visitors": 703,
      "Pageviews": 1811,
      "Sessions": 894,
      "RevenueCents": 0,
      "BounceRate": 57.04697986577181,
      "AvgVisitMs": 80122.9,
      "ViewsPerVisit": 2.0257270693512303
    }
  ]
}

Fields

Field	Meaning
`date`	Bucket start as a naive local timestamp, already in `timezone`
`Visitors`	Distinct visitors seen in the bucket
`Pageviews`	Pageview events in the bucket
`Sessions`	Distinct visits seen in the bucket
`RevenueCents`	Revenue reported in the bucket, in minor units
`BounceRate`	Percentage of the bucket’s visits that were single-page
`AvgVisitMs`	Mean visit duration for the bucket
`ViewsPerVisit`	Pageviews per visit for the bucket

Daily visitors are not period visitors

Summing Visitors across seven days does not give you weekly uniques — it gives you browser-days. And because the visitor id rotates at midnight UTC, period-level “uniques” over a multi-day range are themselves close to browser-days. See How visitors are counted.

Pageviews, Sessions and RevenueCents do sum correctly.

Errors

Status	Body
`401`	`{"error":"Missing or invalid API key"}`
`404`	`{"error":"site not found"}`