openapi: 3.0.1
info:
title: DataForSEO AiOptimization AppData API
description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:
- name: AppData
paths:
/v3/app_data/id_list:
post:
tags:
- AppData
description: 'This endpoint is designed to provide you with a list of IDs and metadata for all App Data tasks created within the specified time period, including both successful and uncompleted tasks.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/id_list/?bash'''
operationId: AppDataIdList
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataIdListRequestInfo'
nullable: true
example:
- datetime_from: '2026-04-12 04:39:39 +00:00'
datetime_to: '2026-04-14 04:39:39 +00:00'
limit: 100
offset: 0
sort: desc
include_metadata: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataIdListResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/errors:
post:
tags:
- AppData
description: 'By calling this endpoint you will receive information about the App Data API tasks that returned an error within the past 7 days.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/errors/?bash'''
operationId: AppDataErrors
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataErrorsRequestInfo'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: pingback_url
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataErrorsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/categories:
get:
tags:
- AppData
description: 'This endpoint will provide you with a full list of app categories available on Google Play.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/categories/?bash'''
operationId: GoogleCategories
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleCategoriesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/locations:
get:
tags:
- AppData
description: 'By calling this endpoint you will receive the list of Google locations supported in App Data API.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/locations/?bash'''
operationId: AppDataGoogleLocations
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleLocationsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/locations/{country}:
get:
tags:
- AppData
description: 'By calling this endpoint you will receive the list of Google locations supported in App Data API.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/locations/?bash'''
operationId: AppDataGoogleLocationsCountry
parameters:
- name: country
in: path
description: 'country ISO code
optional field
specify the ISO code if you want to filter the list of locations by country
example:
us'
required: true
schema:
type: string
nullable: true
example: us
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleLocationsCountryResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/languages:
get:
tags:
- AppData
description: 'By calling this endpoint you will receive the list of Google languages supported in App Data API.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/languages/?bash'''
operationId: AppDataGoogleLanguages
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleLanguagesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_searches/task_post:
post:
tags:
- AppData
description: 'This endpoint will provide you with a list of apps ranking on Google Play for the specified keyword. The returned results are specific to the indicated keyword, as well as the language and location parameters.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_searches/task_post/?bash'''
operationId: GoogleAppSearchesTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppSearchesTaskPostRequestInfo'
nullable: true
example:
- keyword: vpn
location_code: 2840
language_code: en
depth: 30
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppSearchesTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_searches/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_searches/tasks_ready/?bash'''
operationId: GoogleAppSearchesTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppSearchesTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_searches/tasks_ready/?bash'''
operationId: AppDataTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_searches/task_get/advanced/{id}:
get:
tags:
- AppData
description: 'This endpoint will provide you with a list of apps ranking on Google Play for the keyword specified in a POST request. You will also receive additional information about each application: its ID, icon, reviews count, rating, price, and other data. The results are specific to the keyword as well as location and language parameters specified in the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_searches/task_get/advanced/?bash'''
operationId: GoogleAppSearchesTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppSearchesTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_searches/task_get/html/{id}:
get:
tags:
- AppData
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_searches/task_get/html/?bash'''
operationId: GoogleAppSearchesTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppSearchesTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_list/task_post:
post:
tags:
- AppData
description: 'This endpoint will provide you with a list of mobile applications published in the top charts on the Google Play platform. The returned results are specific to the app collection as well as the the language and location parameters.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_list/task_post/?bash'''
operationId: GoogleAppListTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListTaskPostRequestInfo'
nullable: true
example:
- app_collection: topselling_free
location_code: 2840
language_code: en
depth: 100
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_list/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_list/tasks_ready/?bash'''
operationId: GoogleAppListTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_list/task_get/advanced/{id}:
get:
tags:
- AppData
description: 'This endpoint will provide you with a list of applications published in the top charts on the Google Play platform, including app IDs, ratings, prices, titles, and more. The results are specific to the app_collection as well as the location and language parameters specified in the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_list/task_get/advanced/?bash'''
operationId: GoogleAppListTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_list/task_get/html/{id}:
get:
tags:
- AppData
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_list/task_get/html/?bash'''
operationId: GoogleAppListTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_info/task_post:
post:
tags:
- AppData
description: 'This endpoint will provide you with information about the Google Play application specified in the app_id field of the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_info/task_post/?bash'''
operationId: GoogleAppInfoTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppInfoTaskPostRequestInfo'
nullable: true
example:
- app_id: org.telegram.messenger
location_code: 2840
language_code: en
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppInfoTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_info/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_info/tasks_ready/?bash'''
operationId: GoogleAppInfoTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppInfoTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_info/task_get/advanced/{id}:
get:
tags:
- AppData
description: 'This endpoint will provide you with information about the mobile application specified in a POST request. You will receive its ID, icon, description, reviews count, rating, number of installs, images, and other data. The results are specific to the app_id parameter specified in the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_info/task_get/advanced/?bash'''
operationId: GoogleAppInfoTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppInfoTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_info/task_get/html/{id}:
get:
tags:
- AppData
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_info/task_get/html/?bash'''
operationId: GoogleAppInfoTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppInfoTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_reviews/task_post:
post:
tags:
- AppData
description: 'This endpoint will provide you with reviews published on the Google Play platform for the app specified in the app_id field. The returned results are specific to the indicated language and location parameters.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_reviews/task_post/?bash'''
operationId: GoogleAppReviewsTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppReviewsTaskPostRequestInfo'
nullable: true
example:
- app_id: org.telegram.messenger
location_code: 2840
language_code: en
depth: 150
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppReviewsTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_reviews/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_reviews/tasks_ready/?bash'''
operationId: GoogleAppReviewsTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppReviewsTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_reviews/task_get/advanced/{id}:
get:
tags:
- AppData
description: 'This endpoint will provide you with feedback data on applications listed on the Google Play platform, including review ratings, review content, user profile info of each reviewer, review publication dates, and more. The results are specific to the app_id as well as the location and language parameters specified in the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_reviews/task_get/advanced/?bash'''
operationId: GoogleAppReviewsTaskGetAdvanced
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppReviewsTaskGetAdvancedResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_reviews/task_get/html/{id}:
get:
tags:
- AppData
description: 'Description of the fields for sending a request:
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_reviews/task_get/html/?bash'''
operationId: GoogleAppReviewsTaskGetHtml
parameters:
- name: id
in: path
description: 'task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 7 days to request the results of the task at any time'
required: true
schema:
type: string
example: 00000000-0000-0000-0000-000000000000
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppReviewsTaskGetHtmlResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_listings/categories:
get:
tags:
- AppData
description: 'This endpoint will provide you with a full list of app categories available on Google Play.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_listings/categories/?bash'''
operationId: GoogleAppListingsCategories
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListingsCategoriesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/google/app_listings/search/live:
post:
tags:
- AppData
description: 'This endpoint will provide you with a list of apps published on Google Play along with additional information: its ID, icon, reviews count, rating, price, and other data. The results are specific to the title, description, and categories parameters specified in the API request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/google/app_listings/search/live/?bash'''
operationId: GoogleAppListingsSearchLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListingsSearchLiveRequestInfo'
nullable: true
example:
- title: vpn
description: vpn
categories:
- Tools
order_by:
- item.installs_count,asc
filters:
- - item.rating.value
- '>'
- 4.5
limit: 10
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataGoogleAppListingsSearchLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/categories:
get:
tags:
- AppData
description: 'This endpoint will provide you with a full list of app categories available on App Store.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/categories/?bash'''
operationId: AppleCategories
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleCategoriesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/locations:
get:
tags:
- AppData
description: 'By calling this endpoint you will receive the list of Apple locations supported in App Data API.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/locations/?bash'''
operationId: AppleLocations
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleLocationsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/languages:
get:
tags:
- AppData
description: 'By calling this endpoint you will receive the list of Apple languages supported in App Data API.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/languages/?bash'''
operationId: AppleLanguages
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleLanguagesResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/app_searches/task_post:
post:
tags:
- AppData
description: 'This endpoint will provide you with a list of apps ranking on the App Store for the specified keyword. The returned results are specific to the indicated keyword, as well as the location and language parameters.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/app_searches/task_post/?bash'''
operationId: AppleAppSearchesTaskPost
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleAppSearchesTaskPostRequestInfo'
nullable: true
example:
- keyword: vpn
location_code: 2840
language_code: en
depth: 200
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleAppSearchesTaskPostResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/app_searches/tasks_ready:
get:
tags:
- AppData
description: 'The ‘Tasks Ready’ endpoint is designed to provide you with a list of completed tasks that haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/app_searches/tasks_ready/?bash'''
operationId: AppleAppSearchesTasksReady
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/AppDataAppleAppSearchesTasksReadyResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/app_data/apple/app_searches/task_get/advanced/{id}:
get:
tags:
- AppData
description: 'This endpoint will provide you with a list of apps ranking on the App Store for the keyword specified in a POST request. You will also receive additional information about each application: its ID, icon, reviews count, rating, price, and other data. The results are specific to the keyword as well as location and language parameters specified in the POST request.
for more info please visit ''https://docs.dataforseo.com/v3/app_data/apple/app_searches/task_get/advanced/?bas
# --- truncated at 32 KB (211 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-appdata-api-openapi.yml