Getting started

Overview and requirements to query data sets relating to the performance of your media items, players, and advertising ad breaks. Analytics are only available if a media id is assigned to an asset. All assets hosted with JW Player automatically get assigned a media id.

The /v2/sites/site_id/analytics/queries/ route of the Platform Management API v2 allows you to query various data sets relating to the performance of your media items, players, and advertising ad breaks. Responses can be returned in .csv or .json file formats that can be ingested by a data warehouse or analytics solution.


Data availability

Item Description
Earliest available data 2017-01-01
Reporting time zone US - Eastern (UTC -4 / UTC -5)
Data refresh rate Updated approximately every 30 minutes.
Rate limit 60 requests/minute per API token or IP

The number of remaining requests that can be made to the Platform Management API v2 is returned in the response header of each query.
Page length Default: 10 rows per page
Maximum: 100 rows per page
Queries Enterprise or Developer license
• Group by up to two dimensions
• Apply up to five metrics
• Apply up to ten filters

Other licenses
• Group by only one dimension
• Apply up to five metrics
• Apply only one filter
Query date range limit Enterprise or Developer license
92-day window (queries that include at least one premium* metric or dimension)
No limit (queries that do not include any premium* metrics or dimensions)

Other licenses
No limit

* Premium metrics and dimensions are denoted with an asterisk (*) or a cross (☨)


Updated 6 days ago


Next step

Run a report

Getting started


Overview and requirements to query data sets relating to the performance of your media items, players, and advertising ad breaks. Analytics are only available if a media id is assigned to an asset. All assets hosted with JW Player automatically get assigned a media id.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.