---
title: "Get event timeseries"
method: GET
path: "/api/sites/{id}/events/timeseries"
tags: ["Sites"]
---

# Get event timeseries

`GET /api/sites/{id}/events/timeseries`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/sites/{id}/events/timeseries`
- Auth: one of:
  - API key in cookie `hk_token`
  - HTTP bearer
  - API key in header `X-API-Key`

Returns event occurrence counts over time. Optional property filters and repeatable filter=type:value hit-dimension filters restrict the sessions counted.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `event_name` string, required
- `property_key` string
- `property_value` string
- `filter` string
- `dimension_key` 'path' | 'hostname' | 'referrer' | 'referrer_host' | 'device' | 'country' | 'city' | 'provider' | 'asn' | 'browser' | 'language' | 'utm_campaign' | 'utm_content' | 'utm_medium' | 'utm_source' | 'utm_term'
- `dimension_value` string

## Response `200`

Event timeseries

- EventSeriesPoint[]
  - `count` integer
  - `time` string, date-time

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)