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 one of the following base URLs:

• https://r.applovin.com/assetReport (time range)
• https://r.applovin.com/assetAnalyticsReport (date based)

Required time parameters

/assetReport

Parameters	Purpose
range	The time range for this report. Valid values: yesterday, last_7d, last_month.

/assetAnalyticsReport

Parameters	Purpose
start1	The start date of the report. Accepts a date in YYYY-MM-DD format. For example, 2012-10-05.
end1	The end date of the report. Accepts a date in YYYY-MM-DD format. For example, 2012-10-05.

¹This API has a request window of 45 days. Make sure the date parameters are in the last 45 days.

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.
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.
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, 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