WIwistia
Analytics:Account

Show Account Analytics Timeseries

Retrieve analytics timeseries data for the entire account over a date range with configurable granularity. Returns an array of timestamped metric buckets aggregated across all of the account's media.

The date range between start_date and end_date must not exceed 2 years.

Requires api token with one of the following permissions

Read detailed stats

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

An expiring access token created with the all:delegate_to_contact_permissions scope and an account authorization granting the view-stats permission can also be used.

get/analytics/account/timeseries

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/analytics/account/timeseries
  • Auth
    HTTP bearer

Query parameters

start_datestring date required

Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date.

end_datestring date required

End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date.

granularity'daily' | 'weekly' | 'monthly' required

The time granularity for the timeseries data.

Headers

X-Wistia-API-Versionstring required

Response

Success response with timeseries analytics data for the account.

timestampstring date-time

The start of the time bucket in ISO 8601 format.

unique_loadsinteger nullable

The number of unique video loads.

unique_playsinteger nullable

The number of unique video plays.

playsinteger nullable

The total number of video plays.

play_ratenumber float nullable

The percentage of loads that resulted in a play (between 0 and 1).

played_timeinteger nullable

Total time spent watching the video in seconds.

unique_visitorsinteger nullable

The number of unique visitors who loaded the video.

engagement_ratenumber float nullable

The average percentage of the video watched (between 0 and 1).

form_conversionsinteger nullable

The number of form submissions.

Changes

No recorded changes to this operation across all 1 revision of this API.