In-app events

⚠️

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.

In-app events performed by the user during the re-engagement window.
Data freshness: Real-time

Path Params
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
string
required

From date (report start date)

string
required

To date (report end date)

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
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:
event_name
array of strings

Filter in-app events by specified events. Select multiple events by using a comma-separated list.
Example: event_name=af_purchase,ftd

event_name
string
enum

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

Allowed:
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.
string
enum

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

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:
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,gdpr_applies,ad_user_data_enabled,ad_personalization_enabled,total_candidates,engagement_destination
additional_fields
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/csv
application/json