WIwistia
Analytics:Media

Show Media Languages

Retrieve language analytics for a video. Returns a breakdown of plays by viewer browser language, sorted by number of plays in descending order.

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 authorization granting the view-stats permission on this media can also be used.

get/analytics/medias/{mediaId}/languages

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/analytics/medias/{mediaId}/languages
  • Auth
    HTTP bearer

Path parameters

mediaIdstring required

The hashed ID of the media (e.g., "4d23503f70")

The hashed ID of the video.

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.

per_pageinteger

Number of results to return (max 100).

Headers

X-Wistia-API-Versionstring required

Response

Success response with language analytics.

languagestring

The ISO 639-1 language code of the viewer's browser.

playsinteger

The number of video plays from viewers with this language.

percent_of_total_playsnumber float

The percentage of total plays from this language (between 0 and 1).

captions_supportboolean

Whether captions are available for this language.

Changes

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