Asset Reporting API

Use this Reporting API to retrieve aggregated asset level campaign data in either JSON or CSV format.

Data for yesterday is stable after 6:00am UTC.

Request format

Make report requests by sending HTTP GET requests to the following base URL: https://r.applovin.com/assetReport

Required parameters

Parameters	Purpose
api_key	Your Report Key You can find your Report Key on the Axon dashboard by clicking your account in the top right of the dashboard and selecting Keys.
range	The time range for this report. Valid values: yesterday, last_7d
columns	A comma-separated list of columns for the report See the available columns below. For example, asset_id,impressions.

Optional parameters

Parameters	Purpose
format	The format for the report Accepts json or csv. Defaults to json.
limit	The limit on the number of rows you want to return; for example, 500 (use limit and offset to paginate results)
offset	The offset at which you want to begin fetching rows; for example, 100 (use limit and offset to paginate results)

Available columns

Column name	Contains
asset_id	Asset ID
asset_name	Asset name
asset_url	URL of the raw asset before processing
campaign	Campaign name
campaign_id	Unique reference to a campaign. Matches campaign_id_external in the Reporting API.
campaign_package_name	Campaign package name
clicks	Number of clicks
cost	Advertiser spend
creative_set	Creative set name
creative_set_id	Creative set ID. This does not change if the creative set name changes.
ctr	Number of clicks ÷ number of impressions
impressions	Number of impressions

Filtering columns

You can filter reports by asset_id, asset_name, campaign, campaign_id, campaign_package_name, creative_set and creative_set_id. When you do so, you search for a direct match to any of the filters.

For example, if you want to see data only for the specific asset with ID 12345, set the following URL parameter: asset_id=12345

Note

When you filter for asset_name, you must double URL-encode the names (but do not encode the commas when sending multiple values).

For example, if you want to filter for asset names html+3 and video(25), set filter_asset_name=html%252B3,video%252825%2529.

1. Original filter: html+3,video(25)
2. URL-encoded once: html%2B3,video%2825%29 (URL-encodes the +, (, and ) characters, but not the , character)
3. Double encoded: html%252B3,video%252825%2529 (further encodes the % characters from the first URL-encoding)

To filter by a column, add the following URL parameter: filter_columnname=onefilter,anotherfilter,thirdfilter

You can also use negative filters via filter_not_columnname=onefilter,anotherfilter.

Filtering metrics

You can also filter numerical metrics, like impressions and cost, via the greater_than or less_than filters.

To filter a metric to be greater than a specific number, add the following URL parameter: filter_greater_than_columnname=number

To filter a metric to be less than a specific number, add the following URL parameter: filter_less_than_columnname=number

For example, if you want to see data only for assets with impressions greater than 100, set the following URL parameter: filter_greater_than_impressions=100

You can also filter out all 0 values by adding the query parameter not_zero=1.

Sorting columns

You sort reports in a similar way to how you filter reports.

For example, to sort a report by impressions, add the following URL parameter: sort_impressions=ASC

The accepted values are ASC for ascending or DESC for descending. All sorts are lexicographical sort.

Example request

https://r.applovin.com/assetReport?api_key=«your-report-key»&range=yesterday&columns=asset_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC