Reporting API
© 2025 AppLovin. All rights reserved.
Use this Reporting API to get aggregated campaign data in either JSON or CSV format.
Make report requests by sending HTTP GET requests to the following base URL: https://r.applovin.com/report
| 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. |
start1 | The start date of the report Accepts a date in YYYY-MM-DD format or a Unix timestamp. For example, 2012-10-05 or 1336608000. |
end1 | The end date of the report Accepts a date in YYYY-MM-DD format or a Unix timestamp. For example, 2012-10-05 or 1336608000 or now. |
format | The format for the report Accepts json or csv. See details on request format below. |
columns | A comma-separated list of columns for the report See the allowed columns below. For example, day,campaign. |
report_type | Tells the API to respond with publisher or advertiser dataIf you omit this parameter, the API defaults to report_type=publisher. |
1This API has a request window of 45 days. Make sure the date parameters are in the last 45 days.
| Parameters | Purpose |
|---|---|
day_column | Metrics are realtime by default; set this to day when you want to pull metrics under cohort. |
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) |
having | Allows you to filter the results based on numeric values This parameter accepts URL-encoded values of numeric columns, comparison operators, and logical operators, for example: impressions%20%3E%200%20AND%20revenue%20%3E%200 (“impressions > 0 AND revenue > 0”).Note: This slows the response and increases the likelihood of timeouts. |
not_zero | Set this to 1 to filter out results in which all numerical metrics have a value of 0. |
| Column name | Contains |
|---|---|
ad_type | APPOPEN, GRAPHIC, MRAID, PLAY, REWARD, or VIDEO |
application | App name |
application_is_hidden | Is the app hidden in the dashboard? |
bidding_integration | The mediation provider that Axon by AppLovin bids through (MAX for MAX mediation, Google for AdMob Mediation Open Bidding or Google Ad Manager/GAM, None for non-bidding/zone integrations) |
clicks | Number of clicks |
country | Two-letter country code |
ctr | Number of clicks ÷ number of impressions |
day | Date of reporting data |
device_type | phone, tablet, or other |
ecpm | Money earned per 1000 impressions |
| Column name | Contains |
|---|---|
ad | Ad name |
ad_creative_type | GRAPHIC, PLAYABLE, VIDEO, VIDEO_GRAPHIC, or VIDEO_PLAYABLE |
ad_rev_x | Ad revenue during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |
ad_roas_x | Return on ad spend during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, , , , , or ) |
You can filter reports by any column. When you do so, you search for a direct match to any of the filters.
To filter by a column, add the following URL parameter: filter_columnname=onefilter,anotherfilter,thirdfilter
For example, if you want to see data only for the Android platform, set the following URL parameter: filter_platform=Android
See the table above for a list of all columns.
Some columns support negative filters via filter_not_columnname=onefilter,anotherfilter.
The custom_page_id dimension also supports filter_null_custom_page_id, filter_blank_custom_page_id, filter_not_null_custom_page_id, and filter_not_blank_custom_page_id options.
These options do not require a value, i.e. …&filter_not_null_custom_page_id=&filter_not_blank_custom_page_id=&…
You sort reports in a similar way to how you filter reports.
For example, to sort a report by campaign, add the following URL parameter: sort_campaign=ASC
The accepted values are ASC for ascending or DESC for descending.
All sorts are lexicographical sort.
You can request reports in two formats: JSON or CSV.
All data in the reporting API is in UTC (Coordinated Universal Time).
Example advertiser request:
Example publisher request:
hour | Hour of reporting data (only available for the past 30 days) |
impressions | Number of impressions |
package_name | App’s package name or bundle ID |
placement_type | APP_OPEN, BANNER, INTER, LEADER, MREC, NATIVE, or REWARDED_INTER |
platform | android, fireos, ios |
revenue | Money earned |
size | Ad size (BANNER, INTER, LEADER, MREC, or NATIVE) |
store_id | The numeric part of the iTunes ID on iOS, or the package_name on Android.If the iTunes ID is not known to AppLovin, the Bundle ID instead |
zone | Zone name, if available to your account |
zone_id | Zone ID, if available to your account Please contact your account manager if you want to use Zones. |
14d28d30d90d1yad_type | APPOPEN, GRAPHIC, PLAY, REWARD, or VIDEO |
app_id_external | Hashed application ID (commonly referred to as “site ID”) |
application | Source application name |
average_cpa | Average cost per conversion |
average_cpc | Average cost per click |
bidding_and_billing_method | The bidding strategy, either AUTO_BIDDING_WITH_CPM_BILLING, CAPPED_GOAL_BIDDING_WITH_CPM_BILLING, FIXED_GOAL_BIDDING_WITH_CPI_BILLING, or FIXED_GOAL_BIDDING_WITH_CPM_BILLING |
campaign | Campaign name |
campaign_ad_type | ua for user acquisition, or rt for retargeting |
campaign_bid_goal | The campaign bid goal, expressed as a dollar value ($), for CPP and CPE campaigns. You must also request the campaign column when you request this one. |
campaign_id_external | Unique reference to a campaign. This doesn’t change when the campaign is renamed. It is the same value as the {CAMPAIGN_ID} click macro. |
campaign_package_name | Package name or Bundle ID of the promoted app |
campaign_roas_goal | The return on ad spend (ROAS) goal, expressed as a percentage value (%), for IAP ROAS, Ad ROAS, and ROAS campaigns. You must also request the campaign column when you request this one. |
campaign_store_id | The numeric part of the iTunes ID of the promoted app on iOS, or the camaign_package_name otherwise |
campaign_type | The campaign optimization type (CPP, CPE, ad ROAS, IAP ROAS, or ROAS) |
clicks | Number of clicks |
conversions | Number of conversions (installs) |
conversion_rate | Number of conversions ÷ number of impressions |
cost | Advertiser spend |
cost_per_target_event_x | Target event cost-per-event during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d, or 1y) |
country | Two-letter country code |
cpp_x | Cost per purchase during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d, or 1y) |
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 |
custom_page_id | The iOS Custom Product Page or Android Store Listing associated with the creative set |
day | Date of reporting data |
device_type | phone, tablet, or other |
external_placement_id | Encrypted application ID (used with API Source bidding) |
first_purchase | Count of users who made their first purchase (requires revenue postbacks) |
hour | Hour of reporting data (only available for the past 30 days) |
iap_rev_x | IAP revenue during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |
iap_roas_x | IAP return on ad spend during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |
impressions | Number of impressions |
optimization_day_target | Which optimization day you chose to target for the campaign (e.g. day 0 or day 7) |
placement_type | APP_OPEN, BANNER, CTV, INTER, LEADER, MREC, NATIVE, or REWARDED_INTER |
platform | android, fireos, ios, or tvos |
ret_x | Retention during a particular time span (x is one of 1d, 3d, 7d, 14d, or 28d) |
roas_x | Total ROAS during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |
sales | Count of attributed sales events (requires revenue postbacks) |
sales_x | Sales during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d, or 1y) |
size | Ad size (BANNER, INTER, LEADER, MREC, NATIVE, or PRELOAD) |
target_event | The custom event the campaign targets (applies to CPE campaigns only) |
target_event_count | Unique target events |
target_event_count_x | Unique target events during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d, or 1y) |
total_rev_x | Total revenue during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |
traffic_source | AppLovin, or the name of the exchange |
unique_purchasers_x | Unique purchasers during a particular time span (x is one of 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d, or 1y) |