Skip to main content

Query video plays

POST 
/accounts/:accountSlug/analytics/video-plays

Counts video plays within the matched experiences. count is the number of plays. Break the result down with segments (at most 2): day, video. total is always accepted and is the default; a segment not listed here responds 400. Each requested breakdown adds one key field to every row; rows are ordered by count descending, except day rows, which are chronological. startDate and endDate are required and inclusive; endDate cannot be in the future, and a range not scoped to experiences may span at most 4 years. Narrow the query with experiences or folders (slugs that must belong to the account), includeSubfolders, designTool and variant. Rows are paged with limit and offset. An API key reads the analytics of its own account only. Responds 400 when the dates, segments or filters are invalid or exceed the limits above, 401 when the API key is missing, invalid, or revoked, 403 when the key belongs to a different account, and 404 when the account does not exist. Rate limit: API key callers share a single allowance of 250 requests per hour per account across all analytics endpoints, after which they respond 429 with a Retry-After header. Session-authenticated requests are not rate limited.

Request​

Responses​