API reference

Get Master Report

get
https://hq1.appsflyer.com/api/master-agg-data/v4/app/
⚠️

Important

All API V2 tokens generated before March 10, 2026, 19:00 UTC have been revoked. If your token was generated before this date, please regenerate it. Learn how.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
enum
required
Query Params
string
required
^\d{4}\-\d{2}\-\d{2}?$

Lower bound of the LTV attribution date range.
Format: yyyy-mm-dd

string
required
^\d{4}\-\d{2}\-\d{2}?$

Higher bound of the LTV attribution date range

  • Number of the days in the range: 1-31 days
  • For a single day: from and to values are identical.
    Format: yyyy-mm-dd
groupings
array of strings
required
groupings*
kpis
array
required
length ≥ 1
kpis*
calculated_kpis
object

you can add calculated KPIs to your master API reports. This enables you to have your own calculated reports included in your Master API reports.
You can insert any number of built-in KPIs in the calculated KPI formulas.
Standard arithmetic operators are supported: addition (+) encoded as %2b, subtraction (-), multiplication (*), division (/) encoded as %2f.
Calculated KPI field names must start with calculated_kpi_, followed by any valid string, such as, calculated_kpi_purchaserate.

Examples:
First three days combined retention
calculated_kpi_3days_retention=retention_day_1%2Bretention_day_2%2Bretention_day_3

Average revenue per impression
calculated_kpi_rev_per_impression=revenue%2Fimpression

Cohort day 7 ROI
calculated_kpi_roi_day_7=(cohort_day_7_total_revenue_per_user-average_ecpi)%2Faverage_ecpi

pid
array of strings

Used for selecting the rows, which the specified media source/s are displayed in. Comma-separated multiple selection is supported

pid
c
array of strings

Filtering by campaign name

c
af_prt
array of strings

Filtering by agency name

af_prt
af_channel
array of strings

Filtering by channel name

af_channel
af_siteid
array of strings

Filtering by publisher id

af_siteid
geo
array

Filtering by country

geo
string
enum
Allowed:
string
enum
Allowed:
string
enum

By default, the response data is received in CSV file format. If you prefer to get the data in JSON format append format=json to the URI

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?