---
title: "Show Media Embed Locations Timeseries"
method: GET
path: "/analytics/medias/{mediaId}/embed_locations_timeseries"
tags: ["Analytics:Media"]
---

# Show Media Embed Locations Timeseries

`GET /analytics/medias/{mediaId}/embed_locations_timeseries`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/analytics/medias/{mediaId}/embed_locations_timeseries`
- Auth: HTTP bearer

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
```

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](https://docs.wistia.com/reference/post_expiring-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.

## Path parameters

- `mediaId` string, required: The hashed ID of the media (e.g., "4d23503f70")

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `granularity` 'daily' | 'weekly' | 'monthly', required
- `sort_by` 'plays' | 'loads' | 'engagement_rate' | 'play_rate' | 'played_time' | 'unique_visitors'
- `embed_url` string
- `per_page` integer

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Success response with embed location timeseries data.

- object[]
  - `timestamp` string, date-time: The start of the time bucket in ISO 8601 format.
  - `entries` object[]: Embed location metrics for this time bucket. Contains the top locations (ranked by the chosen metric) and optionally an "All other" entry.
    - `embed_domain` string, nullable: The domain where the video is embedded. Null for the "All other" entry.
    - `embed_path` string, nullable: The path on the domain where the video is embedded. Null for the "All other" entry.
    - `embed_url` string, nullable: The full URL where the video is embedded. Null for the "All other" entry.
    - `page_title` string, nullable: The title of the page where the video is embedded. "All other" for the aggregated remainder entry.
    - `loads` integer, nullable: The number of video loads from this location.
    - `unique_loads` integer, nullable: The number of unique video loads from this location (one per visitor session).
    - `plays` integer, nullable: The number of video plays from this location.
    - `unique_plays` integer, nullable: The number of unique video plays from this location (one per visitor session).
    - `play_rate` number, float, nullable: The play rate from this location (between 0 and 1).
    - `played_time` number, float, nullable: Total time spent watching from this location in seconds.
    - `engagement_rate` number, float, nullable: The average engagement rate from this location (between 0 and 1).
    - `unique_visitors` integer, nullable: The number of unique visitors from this location.
    - `cta_conversion_rate` number, float, nullable: The CTA conversion rate from this location (between 0 and 1).

## Other responses

- `400`: Bad request
- `401`: Unauthorized, invalid or missing token
- `403`: Forbidden, token is valid but account does not have access to feature
- `404`: Media not found or does not belong to account
- `500`: Internal server error
- `503`: Analytics service is temporarily unavailable

---

[API](https://skmtc.dev/wistia/apis/analytics-api.md) - [All operations](https://skmtc.dev/wistia/apis/analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/analytics-api/revisions/51b37cd3d37c?raw)