API Reference
Wistia Learning CenterWistia

Show Media Embed Locations Timeseries

get
https://api.wistia.com/modern/analytics/medias//embed_locations_timeseries

Retrieve timeseries analytics for a video broken down by embed location. Returns
an array of timestamped buckets, each containing metrics for the top embed
locations (ranked by the chosen metric) plus an "All other" entry aggregating
the remaining locations.

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
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requestsā€¦
LoadingLoadingā€¦
Path Params
string
required

The hashed ID of the video.

Query Params
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.

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.

string
enum
required

The time granularity for the timeseries data.

Allowed:
string
enum
Defaults to plays

The metric used to rank and select the top embed locations.

Allowed:
uri

Filter results to a single embed URL. When provided, only analytics for
the page matching this URL are returned. Must be a valid HTTP or HTTPS URL.

integer
1 to 100
Defaults to 5

Number of top embed locations per time bucket (max 100). Remaining locations are aggregated into an "All other" entry.

Headers
string
required
Defaults to 2026-05
Responses

404

Media not found or does not belong to account

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoadingā€¦
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?