Show Account Top Content

Rank the account's content by a chosen metric over a date range. Returns the top
media, channels, or folders (controlled by group_by) with their analytics,
answering questions like "what were my most-played videos last month?".

Optionally pass hashed_ids to scope the ranking to a specific set of media
instead of the whole account — useful for fetching analytics for a known list
of videos, still sorted by sort_by.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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
Defaults to media

The type of content to rank.

Allowed:
hashed_ids[]
array of strings
length ≤ 1000

Scope the ranking to these specific media's hashed IDs, rather than the whole account. Only valid with group_by=media.

hashed_ids[]
string
enum
Defaults to plays

The metric to rank content by.

Allowed:
string
enum
Defaults to desc

The sort direction.

Allowed:
integer
1 to 1000

Number of results to return. Defaults to the number of hashed_ids requested, or 10 when hashed_ids is not given.

Headers
string
required
Defaults to 2026-09
Responses

404

One or more of the requested hashed_ids were not found or do not belong to the account

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