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