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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
404One or more of the requested hashed_ids were not found or do not belong to the account