openapi: 3.2.0 info: title: Appsflyer Ad Revenue raw data API version: 1.0.0 description: 'Operations tagged Ad Revenue raw data across 2 of this provider''s published API definitions: appsflyer-raw-data-pull-api-v1-token-openapi.yml, appsflyer-raw-data-pull-api-v2-token-openapi.yml. Each path carries the servers of the definition it was published in.' servers: - url: https://hq.appsflyer.com/export/ - url: https://hq1.appsflyer.com/api/raw-data/export/app/ tags: - name: Ad Revenue raw data paths: /{app-id}/ad_revenue_organic_raw/v5: get: deprecated: false tags: - Ad Revenue raw data summary: Organic ad revenue description: 'Records ad revenue for users not attributed to a media source. Data freshness: Daily ' parameters: - $ref: '#/components/parameters/AppId' - $ref: '#/components/parameters/FromDate' - $ref: '#/components/parameters/ToDate' - $ref: '#/components/parameters/MediaSource' - $ref: '#/components/parameters/Category' - $ref: '#/components/parameters/Currency' - $ref: '#/components/parameters/TimeZone' - $ref: '#/components/parameters/Geo' - $ref: '#/components/parameters/MaximumRows' - in: query name: additional_fields explode: false schema: type: array items: enum: - 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_destination default: - 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_destination responses: '200': $ref: '#/components/responses/Success' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' security: - ApiKeyAuth: [] servers: - url: https://hq.appsflyer.com/export/ /{app-id}/ad_revenue_raw/v5: get: deprecated: false tags: - Ad Revenue raw data summary: Attributed ad revenue description: "Records ad revenue for users attributed to a media source. \nData freshness: Daily\n" parameters: - $ref: '#/components/parameters/AppId' - $ref: '#/components/parameters/FromDate' - $ref: '#/components/parameters/ToDate' - $ref: '#/components/parameters/MediaSource' - $ref: '#/components/parameters/Category' - $ref: '#/components/parameters/ReAttribution' - $ref: '#/components/parameters/Currency' - $ref: '#/components/parameters/TimeZone' - $ref: '#/components/parameters/Geo' - $ref: '#/components/parameters/MaximumRows' - in: query name: additional_fields explode: false schema: type: array items: enum: - 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_destination default: - 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_destination responses: '200': $ref: '#/components/responses/Success' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' security: - ApiKeyAuth: [] servers: - url: https://hq.appsflyer.com/export/ /{app-id}/ad-revenue-raw-retarget/v5: get: tags: - Ad Revenue raw data summary: Retargeting ad revenue description: '> ⚠️ 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](https://support.appsflyer.com/hc/en-us/articles/360004562377-Managing-AppsFlyer-tokens). Ad revenue of users attributed to a retargeting media source during the re-engagement window. Data freshness: Daily ' parameters: - $ref: '#/components/parameters/AppId_2' - $ref: '#/components/parameters/FromDate_2' - $ref: '#/components/parameters/ToDate_2' - $ref: '#/components/parameters/MediaSource' - $ref: '#/components/parameters/Category' - $ref: '#/components/parameters/Currency' - $ref: '#/components/parameters/Geo' - $ref: '#/components/parameters/MaximumRows' - in: query name: additional_fields explode: false schema: type: array items: enum: - 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 default: - 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 responses: '200': $ref: '#/components/responses/Success' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' security: - Bearer-Authentication: [] servers: - url: https://hq1.appsflyer.com/api/raw-data/export/app/ components: schemas: MaximumRows: type: integer enum: - 200000 - 1000000 description: '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 ' minItems: 0 Error: type: string TimeZoneList: type: string description: Choose a time zone minItems: 0 enum: - Africa/Abidjan - Africa/Accra - Africa/Addis_Ababa - Africa/Algiers - Africa/Asmara - Africa/Asmera - Africa/Bamako - Africa/Bangui - Africa/Banjul - Africa/Bissau - Africa/Blantyre - Africa/Brazzaville - Africa/Bujumbura - Africa/Cairo - Africa/Casablanca - Africa/Ceuta - Africa/Conakry - Africa/Dakar - Africa/Dar_es_Salaam - Africa/Djibouti - Africa/Douala - Africa/El_Aaiun - Africa/Freetown - Africa/Gaborone - Africa/Harare - Africa/Johannesburg - Africa/Juba - Africa/Kampala - Africa/Khartoum - Africa/Kigali - Africa/Kinshasa - Africa/Lagos - Africa/Libreville - Africa/Lome - Africa/Luanda - Africa/Lubumbashi - Africa/Lusaka - Africa/Malabo - Africa/Maputo - Africa/Maseru - Africa/Mbabane - Africa/Mogadishu - Africa/Monrovia - Africa/Nairobi - Africa/Ndjamena - Africa/Niamey - Africa/Nouakchott - Africa/Ouagadougou - Africa/Porto-Novo - Africa/Sao_Tome - Africa/Timbuktu - Africa/Tripoli - Africa/Tunis - Africa/Windhoek - America/Adak - America/Anchorage - America/Anguilla - America/Antigua - America/Araguaina - America/Argentina/Buenos_Aires - America/Argentina/Catamarca - America/Argentina/ComodRivadavia - America/Argentina/Cordoba - America/Argentina/Jujuy - America/Argentina/La_Rioja - America/Argentina/Mendoza - America/Argentina/Rio_Gallegos - America/Argentina/Salta - America/Argentina/San_Juan - America/Argentina/San_Luis - America/Argentina/Tucuman - America/Argentina/Ushuaia - America/Aruba - America/Asuncion - America/Atikokan - America/Atka - America/Bahia - America/Bahia_Banderas - America/Barbados - America/Belem - America/Belize - America/Blanc-Sablon - America/Boa_Vista - America/Bogota - America/Boise - America/Buenos_Aires - America/Cambridge_Bay - America/Campo_Grande - America/Cancun - America/Caracas - America/Catamarca - America/Cayenne - America/Cayman - America/Chicago - America/Chihuahua - America/Coral_Harbour - America/Cordoba - America/Costa_Rica - America/Creston - America/Cuiaba - America/Curacao - America/Danmarkshavn - America/Dawson - America/Dawson_Creek - America/Denver - America/Detroit - America/Dominica - America/Edmonton - America/Eirunepe - America/El_Salvador - America/Ensenada - America/Fort_Nelson - America/Fort_Wayne - America/Fortaleza - America/Glace_Bay - America/Godthab - America/Goose_Bay - America/Grand_Turk - America/Grenada - America/Guadeloupe - America/Guatemala - America/Guayaquil - America/Guyana - America/Halifax - America/Havana - America/Hermosillo - America/Indiana/Indianapolis - America/Indiana/Knox - America/Indiana/Marengo - America/Indiana/Petersburg - America/Indiana/Tell_City - America/Indiana/Vevay - America/Indiana/Vincennes - America/Indiana/Winamac - America/Indianapolis - America/Inuvik - America/Iqaluit - America/Jamaica - America/Jujuy - America/Juneau - America/Kentucky/Louisville - America/Kentucky/Monticello - America/Knox_IN - America/Kralendijk - America/La_Paz - America/Lima - America/Los_Angeles - America/Louisville - America/Lower_Princes - America/Maceio - America/Managua - America/Manaus - America/Marigot - America/Martinique - America/Matamoros - America/Mazatlan - America/Mendoza - America/Menominee - America/Merida - America/Metlakatla - America/Mexico_City - America/Miquelon - America/Moncton - America/Monterrey - America/Montevideo - America/Montreal - America/Montserrat - America/Nassau - America/New_York - America/Nipigon - America/Nome - America/Noronha - America/North_Dakota/Beulah - America/North_Dakota/Center - America/North_Dakota/New_Salem - America/Nuuk - America/Ojinaga - America/Panama - America/Pangnirtung - America/Paramaribo - America/Phoenix - America/Port-au-Prince - America/Port_of_Spain - America/Porto_Acre - America/Porto_Velho - America/Puerto_Rico - America/Punta_Arenas - America/Rainy_River - America/Rankin_Inlet - America/Recife - America/Regina - America/Resolute - America/Rio_Branco - America/Rosario - America/Santa_Isabel - America/Santarem - America/Santiago - America/Santo_Domingo - America/Sao_Paulo - America/Scoresbysund - America/Shiprock - America/Sitka - America/St_Barthelemy - America/St_Johns - America/St_Kitts - America/St_Lucia - America/St_Thomas - America/St_Vincent - America/Swift_Current - America/Tegucigalpa - America/Thule - America/Thunder_Bay - America/Tijuana - America/Toronto - America/Tortola - America/Vancouver - America/Virgin - America/Whitehorse - America/Winnipeg - America/Yakutat - America/Yellowknife - Antarctica/Casey - Antarctica/Davis - Antarctica/DumontDUrville - Antarctica/Macquarie - Antarctica/Mawson - Antarctica/McMurdo - Antarctica/Palmer - Antarctica/Rothera - Antarctica/South_Pole - Antarctica/Syowa - Antarctica/Troll - Antarctica/Vostok - Arctic/Longyearbyen - Asia/Aden - Asia/Almaty - Asia/Amman - Asia/Anadyr - Asia/Aqtau - Asia/Aqtobe - Asia/Ashgabat - Asia/Ashkhabad - Asia/Atyrau - Asia/Baghdad - Asia/Bahrain - Asia/Baku - Asia/Bangkok - Asia/Barnaul - Asia/Beirut - Asia/Bishkek - Asia/Brunei - Asia/Calcutta - Asia/Chita - Asia/Choibalsan - Asia/Chongqing - Asia/Chungking - Asia/Colombo - Asia/Dacca - Asia/Damascus - Asia/Dhaka - Asia/Dili - Asia/Dubai - Asia/Dushanbe - Asia/Famagusta - Asia/Gaza - Asia/Harbin - Asia/Hebron - Asia/Ho_Chi_Minh - Asia/Hong_Kong - Asia/Hovd - Asia/Irkutsk - Asia/Istanbul - Asia/Jakarta - Asia/Jayapura - Asia/Jerusalem - Asia/Kabul - Asia/Kamchatka - Asia/Karachi - Asia/Kashgar - Asia/Kathmandu - Asia/Katmandu - Asia/Khandyga - Asia/Kolkata - Asia/Krasnoyarsk - Asia/Kuala_Lumpur - Asia/Kuching - Asia/Kuwait - Asia/Macao - Asia/Macau - Asia/Magadan - Asia/Makassar - Asia/Manila - Asia/Muscat - Asia/Nicosia - Asia/Novokuznetsk - Asia/Novosibirsk - Asia/Omsk - Asia/Oral - Asia/Phnom_Penh - Asia/Pontianak - Asia/Pyongyang - Asia/Qatar - Asia/Qostanay - Asia/Qyzylorda - Asia/Rangoon - Asia/Riyadh - Asia/Saigon - Asia/Sakhalin - Asia/Samarkand - Asia/Seoul - Asia/Shanghai - Asia/Singapore - Asia/Srednekolymsk - Asia/Taipei - Asia/Tashkent - Asia/Tbilisi - Asia/Tehran - Asia/Tel_Aviv - Asia/Thimbu - Asia/Thimphu - Asia/Tokyo - Asia/Tomsk - Asia/Ujung_Pandang - Asia/Ulaanbaatar - Asia/Ulan_Bator - Asia/Urumqi - Asia/Ust-Nera - Asia/Vientiane - Asia/Vladivostok - Asia/Yakutsk - Asia/Yangon - Asia/Yekaterinburg - Asia/Yerevan - Atlantic/Azores - Atlantic/Bermuda - Atlantic/Canary - Atlantic/Cape_Verde - Atlantic/Faeroe - Atlantic/Faroe - Atlantic/Jan_Mayen - Atlantic/Madeira - Atlantic/Reykjavik - Atlantic/South_Georgia - Atlantic/St_Helena - Atlantic/Stanley - Australia/ACT - Australia/Adelaide - Australia/Brisbane - Australia/Broken_Hill - Australia/Canberra - Australia/Currie - Australia/Darwin - Australia/Eucla - Australia/Hobart - Australia/LHI - Australia/Lindeman - Australia/Lord_Howe - Australia/Melbourne - Australia/NSW - Australia/North - Australia/Perth - Australia/Queensland - Australia/South - Australia/Sydney - Australia/Tasmania - Australia/Victoria - Australia/West - Australia/Yancowinna - Brazil/Acre - Brazil/DeNoronha - Brazil/East - Brazil/West - CET - CST6CDT - Canada/Atlantic - Canada/Central - Canada/Eastern - Canada/Mountain - Canada/Newfoundland - Canada/Pacific - Canada/Saskatchewan - Canada/Yukon - Chile/Continental - Chile/EasterIsland - Cuba - EET - EST - EST5EDT - Egypt - Eire - Etc/GMT - Etc/GMT+0 - Etc/GMT+1 - Etc/GMT+10 - Etc/GMT+11 - Etc/GMT+12 - Etc/GMT+2 - Etc/GMT+3 - Etc/GMT+4 - Etc/GMT+5 - Etc/GMT+6 - Etc/GMT+7 - Etc/GMT+8 - Etc/GMT+9 - Etc/GMT-0 - Etc/GMT-1 - Etc/GMT-10 - Etc/GMT-11 - Etc/GMT-12 - Etc/GMT-13 - Etc/GMT-14 - Etc/GMT-2 - Etc/GMT-3 - Etc/GMT-4 - Etc/GMT-5 - Etc/GMT-6 - Etc/GMT-7 - Etc/GMT-8 - Etc/GMT-9 - Etc/GMT0 - Etc/Greenwich - Etc/UCT - Etc/UTC - Etc/Universal - Etc/Zulu - Europe/Amsterdam - Europe/Andorra - Europe/Astrakhan - Europe/Athens - Europe/Belfast - Europe/Belgrade - Europe/Berlin - Europe/Bratislava - Europe/Brussels - Europe/Bucharest - Europe/Budapest - Europe/Busingen - Europe/Chisinau - Europe/Copenhagen - Europe/Dublin - Europe/Gibraltar - Europe/Guernsey - Europe/Helsinki - Europe/Isle_of_Man - Europe/Istanbul - Europe/Jersey - Europe/Kaliningrad - Europe/Kiev - Europe/Kirov - Europe/Lisbon - Europe/Ljubljana - Europe/London - Europe/Luxembourg - Europe/Madrid - Europe/Malta - Europe/Mariehamn - Europe/Minsk - Europe/Monaco - Europe/Moscow - Europe/Nicosia - Europe/Oslo - Europe/Paris - Europe/Podgorica - Europe/Prague - Europe/Riga - Europe/Rome - Europe/Samara - Europe/San_Marino - Europe/Sarajevo - Europe/Saratov - Europe/Simferopol - Europe/Skopje - Europe/Sofia - Europe/Stockholm - Europe/Tallinn - Europe/Tirane - Europe/Tiraspol - Europe/Ulyanovsk - Europe/Uzhgorod - Europe/Vaduz - Europe/Vatican - Europe/Vienna - Europe/Vilnius - Europe/Volgograd - Europe/Warsaw - Europe/Zagreb - Europe/Zaporozhye - Europe/Zurich - GB - GB-Eire - GMT - GMT+0 - GMT-0 - GMT0 - Greenwich - HST - Hongkong - Iceland - Indian/Antananarivo - Indian/Chagos - Indian/Christmas - Indian/Cocos - Indian/Comoro - Indian/Kerguelen - Indian/Mahe - Indian/Maldives - Indian/Mauritius - Indian/Mayotte - Indian/Reunion - Iran - Israel - Jamaica - Japan - Kwajalein - Libya - MET - MST - MST7MDT - Mexico/BajaNorte - Mexico/BajaSur - Mexico/General - NZ - NZ-CHAT - Navajo - PRC - PST8PDT - Pacific/Apia - Pacific/Auckland - Pacific/Bougainville - Pacific/Chatham - Pacific/Chuuk - Pacific/Easter - Pacific/Efate - Pacific/Enderbury - Pacific/Fakaofo - Pacific/Fiji - Pacific/Funafuti - Pacific/Galapagos - Pacific/Gambier - Pacific/Guadalcanal - Pacific/Guam - Pacific/Honolulu - Pacific/Johnston - Pacific/Kiritimati - Pacific/Kosrae - Pacific/Kwajalein - Pacific/Majuro - Pacific/Marquesas - Pacific/Midway - Pacific/Nauru - Pacific/Niue - Pacific/Norfolk - Pacific/Noumea - Pacific/Pago_Pago - Pacific/Palau - Pacific/Pitcairn - Pacific/Pohnpei - Pacific/Ponape - Pacific/Port_Moresby - Pacific/Rarotonga - Pacific/Saipan - Pacific/Samoa - Pacific/Tahiti - Pacific/Tarawa - Pacific/Tongatapu - Pacific/Truk - Pacific/Wake - Pacific/Wallis - Pacific/Yap - Poland - Portugal - ROC - ROK - Singapore - Turkey - UCT - US/Alaska - US/Aleutian - US/Arizona - US/Central - US/East-Indiana - US/Eastern - US/Hawaii - US/Indiana-Starke - US/Michigan - US/Mountain - US/Pacific - US/Samoa - UTC - Universal - W-SU - WET - Zulu Geo: type: string minItems: 0 enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KR - KP - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - AN - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SK - SI - SB - SO - ZA - GS - ES - LK - SD - SR - SJ - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW Geo_2: type: string minItems: 0 enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KR - KP - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - AN - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SK - SI - SB - SO - ZA - GS - ES - LK - SD - SR - SJ - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - UK - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW responses: NotFound: description: 'App 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? ' content: application/json: schema: $ref: '#/components/schemas/Error' example: message: AppsFlyer 404 error message page displays Unauthorized: description: Account may be suspended. Log in to the dashboard and check the account status. content: application/json: schema: $ref: '#/components/schemas/Error' examples: InvalidToken: description: Ask an admin for the current token value: message: Supplied API token is invalid Suspended: description: Log in to the dashboard and check the account status value: message: Account may be suspended Success: content: text/csv: schema: type: string description: Reports returned in CSV format BadRequest: description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Error' examples: CallLimit: value: message: Your API call limit has been reached for the given report type LookBack: description: Use `to` and `from` to limit the date range to 3 months or less. value: message: Raw reports historical lookback is limited to 90 days InvalidLimit: description: report_rows can have the value 200000 or 1000000. value: message: Invalid limit type parameters: MediaSource: description: '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` ' name: media_source in: query schema: type: string example: facebook Currency: name: currency in: query schema: type: string enum: - preferred - USD description: 'Currency of revenue and cost. Aggregate Pull API reports always use the app-specific currency. ' MaximumRows: name: maximum_rows in: query schema: $ref: '#/components/schemas/MaximumRows' FromDate: in: query name: from description: From date (report start date) examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' required: true schema: type: string format: date AppId: in: path name: app-id description: Application ID example: id121244 required: true schema: type: string Category: description: "media_source: Use to filter the call for a specific media source. \nSet both the `media_source` and `category` parameters as follows:\n- For Facebook set `category` and `media_source` to facebook\n- For Twitter set `category` and `media_source` to twitter\n- For all other media sources set `category` to standard and `media_source` to the name of the media source.\nExamples\n- `media_source=facebook&category=facebook`\n- `media_source=abc_example&category=standard`\n" in: query name: category schema: type: string enum: - standard - facebook - twitter TimeZone: name: timezone in: query schema: oneOf: - $ref: '#/components/schemas/TimeZoneList' description: '- **[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. ' ToDate: in: query name: to description: To date (report end date) examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' required: true schema: type: string format: date ReAttribution: name: reattr in: query description: 'Get retargeting conversions data. **[Default]** is false - user acquisition data (UA) campaigns returns. If true, retargeting conversion returns. ' schema: type: string enum: - true - false default: false Geo: name: geo in: query schema: $ref: '#/components/schemas/Geo' description: 'Filter the data by country code. Limitation: You can set only one country code filter per API call. ' ToInstallTime: in: query name: to_install_time description: To install time examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' schema: type: string pattern: ^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$ FromInstallTime: in: query name: from_install_time description: From install time examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' schema: type: string pattern: ^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$ FromDate_2: in: query name: from description: From date (report start date) examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' required: true schema: type: string pattern: ^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$ Agency: in: query name: agency description: 'Use to filter by a specific agency ' schema: type: array items: type: string examples: SingleAgency: summary: filter by single agency value: agency=agency-name MediaSourceAndAgency: summary: filter by media_source & agency value: media_source=media-source-name&agency=agency-name MultipleAgencies: summary: filter by multiple agencies value: agency=agency-name-a,agency-name-b AppId_2: in: path name: app-id description: 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](https://dev.appsflyer.com/hc/reference/raw_data_pull_api_tokenv2-overview#supported-non-mobile-platform-prefixes-and-examples). example: id121244 required: true schema: type: string ToDate_2: in: query name: to description: To date (report end date) examples: DateOnly: summary: Date only value: '2022-04-22' DateHourMin: summary: Date-Hour-Mins value: 2022-04-22 21:45 DateHourMinSecs: summary: Date-Hour-Mins-Secs value: '2022-04-22 21:45:23' required: true schema: type: string pattern: ^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}(:\d{2})?)?$ securitySchemes: ApiKeyAuth: type: apiKey in: query name: api_token description: 'Pull API token for authentication. [Get the API token in the Dashboard](https://support.appsflyer.com/hc/en-us/articles/360004562377) ' Bearer-Authentication: type: http scheme: bearer description: "**Important: API V2 Token Revocation**\n\nAll 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](https://support.appsflyer.com/hc/en-us/articles/360004562377-Managing-AppsFlyer-tokens).\n\nAuthorization HTTP header containing API V2 token (bearer token) is required.\n\n The admin [gets the V2 token in the dashboard](https://support.appsflyer.com/hc/en-us/articles/360004562377) " x-refined-from: - appsflyer-raw-data-pull-api-v1-token-openapi.yml - appsflyer-raw-data-pull-api-v2-token-openapi.yml