All AppsFlyer CSV reports are available by APIs. Refer to your AppsFlyer account by going to the API Access Page for your secret key and examples.
Raw Data Reports
Installations: https:// hq.appsflyer.com/export/{app_id}/installs_report/v5?api_token={api token}&from={from_date}&to={to_date}
In-App Events: https:// hq.appsflyer.com/export/{app_id}/in_app_events_report/v5?api_token={api token}&from={from_date}&to={to_date}
Performance Reports
Partners Report: https:// hq.appsflyer.com/export/{app_id}/partners_report/v5?api_token={api token}&from={from_date}&to={to_date}
Daily Report: https:// hq.appsflyer.com/export/{app_id}/partners_report/v5?api_token={api_token}&from={from_date}&to={to_date}
Geo Report: https:// hq.appsflyer.com/export/i{app_id}/geo_report/v5?api_token={api_token}&from={from_date}&to={to_date}
Partners by Date Report: https:// hq.appsflyer.com/export/{app_id}/partners_by_date_report/v5?api_token={api_token}&from={from_date}&to={to_date}
Geo by Date Report: https:// hq.appsflyer.com/export/{app_id}/geo_by_date_report/v5?api_token={api_token}&from={from_date}&to={to_date}
New API Version (V5)
-
Changes:
-
New version (v5) groups Facebook campaigns only by campaign and not by campaign & ad group.
-
Export data page for aggregated reports uses the new API version (v5)
Unchanged:
-
The existing API (v4) is still available for use
-
The new version does not apply any change to the file format or headers
-
NOTE: To use V4 Performance Reports, change v5 to v4.
For example, the v5 (in red) should be changed to v4.
https:// hq.appsflyer.com/export/i{app_
API Parameters
- api_token is the user's external API Authorization Key: "{Account owner API Key should be used}"
"api_token", "from" and "to" parameters are required!
Optional - Filtering reports by media source and re-attribution
Filtering the reports to list only a specific media source is available by adding 2 parameters to the request:
- category is an optional parameter. It is used to filter either by a specific media source - category=standard , or Facebook campaign - category=facebook.
- media_source is also optional and dictates the actual media source. For example - for a Raw Report with category and time zone:
https://hq.appsflyer.com/export/com.coverfy.app/installs_report/v5?api_token=xxxx&from=2016-11-09&to=2016-11-09&category=standard&media_source=googleadwords_int&timezone= %2B01%3A00 - reattr=true - used to retrieve re-targeting attribution reports.
For Raw Reports, the following parameters are also available:
- from_date is a the report's start date in the format of "yyyy-mm-dd" or "yyyy-mm-dd hh:mm". For example: 2010-01-01 or 2010-01-01%2000%3A15
- to_date is the report's end date in the format of "yyyy-mm-dd" or "yyyy-mm-dd hh:mm" . For example: 2010-01-01 or 2010-01-01%2000%3A30
- event_name can be used to filter the raw in-app events report data to include only a specific event or events. For example: event_name=af_purchase,ftd
Time Zone and Currency
- timezone (optional) Add timezone= in the Pull API link to receive the report in the selected timezone (rather than GMT, by default). For raw data reports AppsFlyer supports two time zone formats, numerical (eg. +10:00) or Joda-Time (eg. Europe/Madrid). Joda-Time time zone format takes into account daylight saving time.
For example: timezone=%2B10:00 (url-encoded for +10:00). For the performance reports only Joda-Time format is supported. For example:
https://hq.appsflyer.com/export/com.coverfy.app/daily_report/v5?api_token=xxxxxxxx&from=2016-11-09&to=2016-11-09&category=standard&media_source=googleadwords_int&timezone=Europe/Madrid - currency (optional) is used to receive the Revenue and Cost data in your selected currency, rather than in USD, which is the default option. This is set by the account admin.
currency=preferred is used to receive Revenue and Cost data in your selected currency.
API Policy
Click here to see our API Policy
NOTE: By default, the Pull API Performance Report shows Facebook data at Campaign level only. Add "&category=facebook" to enable the report to present Facebook information at both the Ad Set and Ad level. This is relevant for Facebook only.