JUMP TOCTRL-/OverviewAPI Reference OverviewONELINKHiddenTitleDeep linking REST APIiOS deep linking requestDeep linking for IOSpostAndroid deep linking requestDeep linking for AndroidpostOneLink APIOneLink REST APIOverviewCreate OneLink attribution linkpostGet OneLink attribution linkgetUpdate OneLink attribution linkputDelete OneLink attribution linkdeleteTraits and limitationsRaw data reportHiddenTitlePush API Configuration APIMessage FieldsRetrieve per platformgetEvent TypesRetrieve per attributing-entitygetURL ValidationValidate URLpostManage Push API configurationUpdate Push API configurationputGet Push API configurationgetAuthentication TokenSet Push API Authentication TokenputDelete Push API Authentication TokendeleteRaw Data Pull API V2 TokenOverviewRaw data reports (non-organic)InstallsgetIn-app eventsgetUninstallsgetReinstallsgetRaw data reports (organic)Organic InstallsgetOrganic in-app eventsgetOrganic uninstallsgetOrganic reinstallsgetRetargetingConversions (re-engagements & re-attributions)getIn-app eventsgetAd Revenue raw dataAttributed ad revenuegetOrganic ad revenuegetRetargeting ad revenuegetProtect360 fraudInstallsgetPost-attribution installsgetIn-app eventsgetPost-attribution in-app eventsgetClicksgetBlocked install postbacksgetPostbacksInstall postbacksgetIn-app event postbacksgetRetargeting in-app event postbacksgetRetargeting conversions postbacksgetAggregate Pull API V2 TokenOverviewAggregate (user acquisition and retargeting)PartnersgetPartners dailygetDailygetGeogetGeo dailygetMaster APIOverviewMaster ReportGet Master ReportgetMaster freshness APIFreshness ReportGet last updategetMeasurementsHiddenTitleEngagements APIClick EngagementClick EngagementgetClick EngagementpostImpression EngagementImpression EngagementgetImpression EngagementpostPC/Console/CTV Events APIOverviewMeasure first app opensMeasure first app openspostMeasure sessionsMeasure sessionspostMeasure in-app eventsMeasure in-app eventspostRetrieving User AgentServer-to-server events API (for mobile)OverviewInapp EventsSend EventpostFAQWEB Server-TO-Server APIEvents managementAssociate Customer User ID with AF User IDpostSend EventpostPreload Measurement APIDownload EventsDownload eventpostPreload C2S Measurement APIDownload EventsDownload eventpost[Legacy] Server-to-server events API (for mobile)Inapp EventsSend EventpostSKANHiddenTitleSKAN CV schema API for ad networksSKAN CV schema API for ad networksOverviewGet SKAN 4 CV schemagetGet SKAN 3 CV schemagetSKAN CV Schema API for AdvertisersConversion value (CV) schemaGet CV schemagetSKAN conversion studio APISKAN conversion studio APIOverviewCopy SKAN schemapostGet SKAN schemagetSKAN aggregated postback by arrival date APISKAN postbacksGet aggregated postbacksgetSKAN aggregated performance report APISKAN performance reportGet performance reportgetROIHiddenTitleTrue Revenue tax APITax rate rulesOverviewCreate tax rate rulepostGet a filtered list of taxes or the entire tax catalog if no filters are providedgetAdRevenue Account Integrations APIAd revenue partner integration APIAccount IntegrationSet integrationpostList integrationsgetInCost APIOverviewInCost uploaderUpload cost datapostInCost job statusGet job statusgetMobileHiddenTitleGCD API for SDK attribution testingConversion Data for SDK attribution testingGet the conversion datagetTest Console APIEventsRetrieve eventsgetAllowed devicesAdd devicepostDelete devicedeleteAnalyticsHiddenTitleCohort APICohort ReportCreate Cohort ReportpostMarketplaceHiddenTitlePartner integration settings APIUnique partner integration parametersGet a list of unique parametersgetActive integrationsGet active integrationsgetGet active integration parametersgetIntegration settingsCopy partner integration settingspostDeprecated - Copy partner integration settingspostGoogle Play install referrerSet install referrer decryption keypostAudiencesHiddenTitleAudience External APIOverviewCreate audienceCreate new imported audiencepostAudience connectionsList partner connections for audiencegetConnect audience to existing partnersputAudience splitGet split percentages for audiencegetUpdate split percentages for audienceputAudience uploadUpload audience to partners nowpostAccount connectionsList partner connections for accountgetAccount splitsGet split percentages for accountgetActive audiencesGet active audiences for accountgetPauses audiencePause audiencepostAdditional Identifiers APIAdditional Identifiers HandlingAdd, Modify or RemoveputAudience Import APIImport audienceImport a new audiencepostManagementHiddenTitleApp list API for Ad NetworksOverviewGet app listApp listgetUser managementOverviewManaging users in bulkCreate bulk userspostGet usersgetDelete usersdeleteManaging rolesGet rolesgetApp management API V2.0OverviewError messagesSupported formatsApp managementAdd apppostUpdate appputDelete appdeleteMiscHiddenTitleClick Signing APIOverviewGet configGet click signing configgetUpdate configUpdate click signing configputRemove excluded appdeleteCircuit breakerCircuit breakerputAdd excluded appAdd excluded apppostReportReportgetTestTestpostGenerate secret keyGenerate secret keypostRevoke secret keyRevoke secret keydelete English English 简体中文 Français Bahasa Indonesia 日本語 한국어 Español Português Русский Tiếng Việt Post-attribution installsget https://hq1.appsflyer.com/api/raw-data/export/app/{app-id}/detection/v5Reports include installs attributed to a media source but later found to be fraudulent. Data freshness: Real-timeLog in to see full request historyURL ExpiredThe URL for this request expired after 30 days.Path Paramsapp-idstringrequiredApplication IDQuery ParamsfromstringrequiredFrom date (report start date)tostringrequiredTo date (report end date)media_sourcestringUse 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 categorystringmedia_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 standardfacebooktwittercurrencystringCurrency of revenue and cost. Aggregate Pull API reports always use the app-specific currency.preferredUSDtimezone [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. TimeZoneListgeostringFilter the data by country code. Limitation: You can set only one country code filter per API call.AFAXALDZASADAOAIAQAGARAMAWAUATAZBSBHBDBBBYBEBZBJBMBTBOBABWBVBRIOBNBGBFBIKHCMCACVKYCFTDCLCNCXCCCOKMCGCDCKCRCIHRCUCYCZDKDJDMDOECEGSVGQEREEETFKFOFJFIFRGFPFTFGAGMGEDEGHGIGRGLGDGPGUGTGGGNGWGYHTHMVAHNHKHUISINIDIRIQIEIMILITJMJPJEJOKZKEKIKRKPKWKGLALVLBLSLRLYLILTLUMOMKMGMWMYMVMLMTMHMQMRMUYTMXFMMDMCMNMEMSMAMZMMNANRNPNLANNCNZNINENGNUNFMPNOOMPKPWPSPAPGPYPEPHPNPLPTPRQARERORURWBLSHKNLCMFPMVCWSSMSTSASNRSSCSLSGSKSISBSOZAGSESLKSDSRSJSZSECHSYTWTJTZTHTLTGTKTOTTTNTRTMTCTVUGUAAEGBUSUMUYUZVUVEVNVGVIWFEHYEZMZWmaximum_rowsintegerMaximum 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 2000001000000from_install_timestringFrom install timeto_install_timestringTo install timeagencyarray of stringsUse to filter by a specific agency Note: If you use both the agency filter and media source filters, the media source filters don’t apply for non-transparent agencies. This means that for non-transparent agencies, all data is included, not just the data from the filtered media sourcesagencyADD stringadditional_fieldsarrayDefaults to contributor3_match_type,detection_date,gp_click_time,match_type,gp_broadcast_referrer,gp_install_begin,custom_data,fraud_reason,rejected_reason,device_download_time,keyword_match_type,contributor1_match_type,contributor2_match_type,device_model,fraud_reasons,fraud_sub_reason,gp_referrer,install_time_tz,device_category,rejected_reason_value,network_account_id,install_app_store,amazon_aid,att,engagement_type,blocked_reason_valueadditional_fields contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_value contributor3_match_typedetection_dategp_click_timematch_typegp_broadcast_referrergp_install_begincustom_datafraud_reasonrejected_reasondevice_download_timekeyword_match_typecontributor1_match_typecontributor2_match_typedevice_modelfraud_reasonsfraud_sub_reasongp_referrerinstall_time_tzdevice_categoryrejected_reason_valuenetwork_account_idinstall_app_storeamazon_aidattengagement_typecontributor1_engagement_typecontributor2_engagement_typecontributor3_engagement_typeblocked_reason_valueADD Responses 200Reports returned in CSV formatResponse bodystring 400Bad RequestResponse bodystring 401Account may be suspended. Log in to the dashboard and check the account status.Response bodystring 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? Response bodystringUpdated about 1 year ago InstallsIn-app eventsDid this page help you?YesNo