Retargeting ad revenue

⚠️

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.

Ad revenue of users attributed to a retargeting media source during the re-engagement window.
Data freshness: Daily

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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:
string
enum

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

Allowed:
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,gp_click_time,match_type,mediation_network,oaid,deeplink_url,blocked_reason,blocked_sub_reason,gp_broadcast_referrer,gp_install_begin,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,rejected_reason_value,ad_unit,keyword_id,placement,network_account_id,install_app_store,amazon_aid,engagement_type,total_candidates,engagement_destination
additional_fields
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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