Installs

get

https://hq1.appsflyer.com/api/raw-data/export/app/{app-id}/installs_report/v5

⚠️
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.

Records non-organic installs. The record is generated when a user opens the app for the first time.
Data freshness: Real-time

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

app-id

string

required

Application ID. For non-mobile apps, use the unified app ID with the required platform prefix, for example nativepc-, steam-, epic-, roku-, xbox-, and others. For the complete list see the overview.

Query Params

from

string

required

^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$

From date (report start date)

string

required

^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$

To date (report end date)

media_source

string

Use to filter by a specific media source
Set both the category and media_source parameters as follows:

For Facebook set category and media_source to facebook
For Twitter set category and media_source to twitter
For all other media sources set category to standard and media_source to the name of the media source.
Examples
media_source=facebook&category=facebook
media_source=abc_example&category=standard

category

string

enum

media_source: Use to filter the call for a specific media source.
Set both the media_source and category parameters as follows:

For Facebook set category and media_source to facebook
For Twitter set category and media_source to twitter
For all other media sources set category to standard and media_source to the name of the media source.
Examples
media_source=facebook&category=facebook
media_source=abc_example&category=standard

Allowed:

currency

string

enum

Currency of revenue and cost.
Aggregate Pull API reports always use the app-specific currency.

Allowed:

timezone

enum

[Default] If the parameter is not sent, data returns using UTC.
Data returns using the app-specific time zone.
Time zone format takes into account daylight saving time.
The timezone value must be identical to the value in the app settings page. For example, if the timezone setting is Paris, the timezone value in the Pull API URL should be timezone=Europe/Paris.
Pulling data in the selected time zone is only available from the date when the timezone setting was made. Any data prior to the date of the change uses UTC as the timezone.

Choose a time zone

geo

string

enum

Filter the data by country code.
Limitation: You can set only one country code filter per API call.

maximum_rows

integer

enum

Maximum number of rows returned by a single API call.

[Default] if no value is sent, up to 200K rows
200000: Up to 200K rows return
1000000: Up to 1M rows return

Allowed:

agency

array of strings

Use to filter by a specific agency

agency

additional_fields

array

Defaults to store_reinstall,impressions,contributor3_match_type,custom_dimension,conversion_type,gp_click_time,match_type,mediation_network,oaid,deeplink_url,blocked_reason,blocked_sub_reason,gp_broadcast_referrer,gp_install_begin,campaign_type,custom_data,rejected_reason,device_download_time,keyword_match_type,contributor1_match_type,contributor2_match_type,device_model,monetization_network,segment,is_lat,gp_referrer,blocked_reason_value,store_product_page,device_category,app_type,rejected_reason_value,ad_unit,keyword_id,placement,network_account_id,install_app_store,amazon_aid,att,engagement_type,contributor1_engagement_type,contributor2_engagement_type,contributor3_engagement_type,gdpr_applies,ad_user_data_enabled,ad_personalization_enabled,total_candidates,engagement_destination

additional_fields

200Reports returned in CSV format

400Bad Request

401Account may be suspended. Log in to the dashboard and check the account status.

404App ID wasn't found. Ensure that the app ID is correct. iOS apps must start with ID. The token doesn't match the app. Are you using the correct token?