Find Media By Embed Location

Find the media embedded at a given URL. Returns the hashed IDs of the
account's media that recorded activity at that embed location during the
date range, ranked by plays. The resulting hashed IDs can be passed to
other endpoints, such as Show Account Top Content's hashed_ids[] filter,
to fetch analytics for those media.

The domain of embed_url is always matched exactly. Its path is matched
exactly by default, or as a prefix with path_match=prefix (e.g.
/pricing also matching /pricing/plans). A path that is empty or /
is ignored, returning media across all paths on the domain.

Embed location data is retained for 6 months; a start_date older than
that returns a 422 error. When start_date and end_date are omitted,
the full 6-month queryable window is used.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The URL of the page to look up, e.g. https://example.com/pricing. The protocol is optional (https is assumed), so example.com/pricing also works.

date

Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be within the last 6 months. Defaults to 6 months ago, the start of the queryable window.

date

End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Defaults to tomorrow, so today's activity is included.

string
enum
Defaults to exact

How to match the path of embed_url against embed locations. exact requires the path to match exactly; prefix matches any embed path starting with it.

Allowed:
integer
1 to 1000
Defaults to 100

Number of media hashed IDs to return (max 1000).

Headers
string
required
Defaults to 2026-09
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json