v1

latestOpenAPI 3.0.12026-07-2210997354.2 KB

Analytics

Ads analytics

Retrieve analytics overview for all ads in a project.

get/projects/{project_id}/ads/analytics

Query parameters

metrics[]string[]

The metrics that you want to fetch data for

media_variants[]string[]

The media variants to fetch data for

media_formats[]string[]

The media formats to fetch data for

time_range[start]string

The start date of the aggregation period. The value of this property should be a string in the format yyyy-mm-dd according to ISO 8601.

time_range[end]string

The end date of the aggregation period. The value of this property should be a string in the format yyyy-mm-dd according to ISO 8601. If this is set to today, the current day is still in progress and therefore only partial analytics data is returned until the day ends.

pagination[limit]integer

'limit' sets the number of results to return in each page.

pagination[offset]integer

'offset' sets the first position to return from the results of the query. The default is 0, which starts the page at the first result.

order[by]'listens'

This is used to order analytics by number of listens or average listen time or average listen duration

order[dir]'asc' | 'desc'

This is used to order analytics in the ascending or descending order

access_tiers[]string[]

The access tiers to fetch data for

filter[title]string

filter[ids][]integer[]

Response

idinteger

Ad identifier

titleinteger

Ad title (internal identifier)