Master API - Customizable Aggregated Data API

AppsFlyer's new customizable aggregated data API allows you to create your own report containing Lifetime Value (LTV), Retention and Activity-based KPIs, for either one or all of your apps. In addition, you can define the different groups according to which you want to view the data.  The data is available in either CSV or JSON formats.

To use the API, compose the URL which defines the data that you want to view.

Master API is an AppsFlyer premium feature.

API Endpoint

Every call to the Master Report API must begin with the following endpoint:

https://hq.appsflyer.com/export/master_report/v4?api_token=[api_token]&app_id=[app_id]&from=[from_date]&to=[to_date]

All the received fields in the response are according to V5 format.
By default, the response data is received in CSV file format. If you prefer to get the data in JSON format add "&format=json" to the URL.

Additional Parameters

Available Groupings

These are for collecting the data into groups to allow easier and more accurate examination of the information.

List of KPIs

The Key Performance Indicators (KPI) are the metrics used for gaining an insight into the behavior of your app in different ways. 

Sample Requests

To save you time here is a list of master API URLs you can cut and paste to get different reports.
Before using a URL make sure to:

1. Replace the app name from com.greatapp to your android or iOS app's ID
2. Replace [TOKEN] with your account's API token
3. Replace the from and to dates to your preferred date range
4. Change the KPIs according to your preferences
5. If your app has a different timezone or currency than the default UTC (GMT) and USD add "&timezone=preferred" and/or "&currency=preferred" to the query URL

• Elaborate Facebook report - compare all your Facebook ads performance:
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&pid=facebook&groupings=pid,c,af_adset_id,af_ad_id
  &kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,roi

• Elaborate Adwords report - compare all your Adwords ads performance:
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&pid=googleadwords_int&groupings=pid,c,af_adset_id,af_ad_id
  &kpis=installs,sessions,loyal_users,cost,revenue,arpu_ltv,roi

• Specific Countries report (Eg. US and Canada for North America):
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=geo,pid,c
  &kpis=installs,clicks,impressions,sessions,loyal_users,cost,revenue,arpu_ltv,roi&geo=us,ca

• Keywords Effectiveness report - compare ROI and other KPIs of users according to their used keyword for installing:
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=af_keywords
  &kpis=roi,arpu_ltv,average_ecpi,installs,loyal_users_rate,cost,revenue

• Agencies performance report - compare performance of all agencies working for you:
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=af_prt,pid,c&kpis=installs,loyal_users_rate

• Affiliates performance report - find the best affiliates that get you most installs from quality users under the media source 'affiliates' (more about tracking affiliates):
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=af_siteid&pid=affiliates
  &kpis=installs,loyal_users_rate,arpu_ltv,retention_day_1,retention_rate_day_1,retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,retention_day_30,retention_rate_day_30

• Attribution Type report - do your best users come from clicks, impressions or organic?:
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=attributed_touch_type
  &kpis=installs,sessions,loyal_users_rate,arpu_ltv

• Retargeting Users Effectiveness report - which type of campaigns gets more revenue, UA or re-targeting?
  

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=is_primary&kpis=revenue

• Networks Retention report - compare all networks installs for users retention on day 1, 7, 15, 22 and 30 after the install:

  https://hq.appsflyer.com/export/com.greatapp/master_report/v4?api_token=[TOKEN]
  &from=[yyyy-mm-dd]&to=[yyyy-mm-dd]&groupings=pid,c
  &kpis=installs,loyal_users_rate,retention_day_1,retention_rate_day_1,retention_day_7,retention_rate_day_7,retention_day_15,retention_rate_day_15,retention_day_22,retention_rate_day_22,retention_day_30,retention_rate_day_30

IMPORTANT NOTES 

• If the Admin changed the preferred time zone in the dashboard within the requested time range, the generated report contains values from the last change only.
• Costs, clicks and impressions related to Facebook and Google are currently not supported.
• Specific groupings are only available for LTV KPIs, Activity or Retention KPIs. The API returns N/A when the data for a specific KPI is not available. For example, requesting retention_rate_day_7 grouped by af_channel will return “N/A”.
• Data Freshness: The data is aggregated on a daily basis.  For users in time zone UTC - (minus) it may take up to 48 hours and for users in time zone UTC + (plus) it may take up to 24 hours for the report to be populated with data.
• If all apps have the same configuration (whether by default or not), the common configuration is used. Otherwise, (different configurations per app), GMT and USD are not used.
• Maximum lines count: 200K