Statistics API¶

The numbers behind the Statistics dashboard are available through the API, per project.

Performance stats¶

GET /api/v1/project/<project_id>/stats/performance

Query parameter	Required	Meaning
`start_dt`	yes	Start of the period — ISO 8601 datetime with a timezone.
`end_dt`	yes	End of the period. Must be after `start_dt`; the range can span at most 365 days.
`video_id`	no	Restrict to a single video.
`country_geoname_id`	no	Restrict to one country, by its geonames.org ⧉ id.

Days are bucketed in the project's timezone.

The response is columnar — parallel arrays, one entry per day:

{
  "performance": {
    "dt":       ["2026-06-01T00:00:00+00:00", "2026-06-02T00:00:00+00:00"],
    "views":    [120, 95],
    "plays":    [80, 61],
    "seconds":  [9400, 7100],
    "finishes": [25, 18]
  }
}

Metric	Meaning
`views`	Player loads.
`plays`	Playback starts.
`seconds`	Seconds of video watched.
`finishes`	Viewers who reached the end of the video.

Derived metrics from the dashboard map directly: play rate = plays ÷ views, completion = finishes ÷ plays, watch time = sum(seconds).

Limits¶

Stats requests are limited to 5 concurrent requests per project (see Limits); a request over the limit gets 429. For dashboards of your own, cache results rather than querying per page view.