version |
string |
the current version of the API |
status_code |
integer |
general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string |
general informational message
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
total tasks cost, USD |
tasks_count |
integer |
the number of tasks in the tasks array |
tasks_error |
integer |
the number of tasks in the tasks array that were returned an error |
tasks |
array |
array of tasks |
id |
string |
task identifier
unique task identifier in our system in the UUID format |
status_code |
integer |
status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here |
status_message |
string |
informational message of the task
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
cost of the task, USD |
result_count |
integer |
number of elements in the result array |
path |
array |
URL path |
data |
object |
contains the same parameters that you specified in the POST request |
result |
array |
array of results |
total_count |
integer |
the total number of relevant results in the database |
count |
integer |
the number of items in the results array
|
offset |
integer |
offset in the results array of returned apps
|
offset_token |
string |
token for subsequent requests
you can use this parameter in the POST request to avoid timeouts while trying to obtain over 100,000 results in a single request
|
items |
array |
array of apps and related data
|
app_id |
string |
ID of the returned app
|
se_domain |
string |
search engine domain in a POST array |
location_code |
integer |
location code in a POST array |
language_code |
string |
language code in a POST array |
check_url |
string |
direct URL to search engine results
you can use it to make sure that we provided accurate results |
time_update |
string |
date and time when SERP data was last updated
in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ”
example:
2023-05-23 10:16:19 +00:00 |
item |
object |
detailed information about the app
|
type |
string |
the item’s type
possible item types: "google_play_info_organic" |
rank_group |
integer |
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank among all the listed apps
absolute position among all apps on the list |
position |
string |
the alignment of the element in SERP
can take the following values: left |
app_id |
string |
ID of the returned app
|
title |
string |
title of the returned app
|
url |
string |
URL to the app page on Google Play
|
icon |
string |
URL to the app icon
|
description |
string |
description of the returned app
|
reviews_count |
integer |
the total number of reviews the app has
|
rating |
object |
average rating of the app |
rating_type |
string |
the type of the rating
can take the following values: Max5 |
value |
float |
the value of the rating |
votes_count |
integer |
the amount of feedback
in this case, the value will be null |
rating_max |
integer |
the maximum value for a rating_type
the maximum value for Max5 is 5 |
price |
object |
price of the app |
current |
float |
current price
refers to the current price indicated in the element |
regular |
float |
regular price
refers to the regular price indicated in the element |
max_value |
float |
the maximum price
refers to the maximum price indicated in the element |
currency |
string |
currency of the listed price
ISO code of the currency applied to the price |
is_price_range |
boolean |
price is provided as a range
indicates whether a price is provided in a range |
displayed_price |
string |
price string in the result
raw price string as provided in the result |
is_free |
boolean |
indicates whether the app is free
|
main_category |
string |
app category
Google Play category relevant to the app |
installs |
string |
approximate number of app installs
|
installs_count |
integer |
accurate number of app installs
|
developer |
string |
name of the app developer |
developer_id |
string |
ID of the developer on Google Play |
developer_url |
string |
URL to the developer page on Google Play |
developer_email |
string |
email address of the developer
|
developer_address |
string |
physical address of the developer
|
developer_website |
string |
official website of the developer
|
version |
string |
current version of the app
|
minimum_os_version |
string |
minimum OS version required to install the app
|
size |
float |
size of the app
|
released_date |
string |
date and time when the app was released
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
last_update_date |
string |
date and time when the app was last updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
update_notes |
string |
update notes
contains the latest update notes from the developer
|
images |
array |
app images
contains URLs to the images published on the app page on Google Play |
videos |
array |
app videos
contains URLs to the video published on the app page on Google Play |
similar_apps |
array |
similar apps
displays apps similar to the app in a POST request |
app_id |
string |
ID of the app
|
title |
string |
title of the app
|
url |
string |
URL to the app page on Google Play
|
more_apps_by_developer |
array |
similar apps
information about apps built by the same developer |
app_id |
string |
ID of the app
|
title |
string |
title of the app
|
url |
string |
URL to the app page on Google Play
|
genres |
array |
app genres
contains relevant app categories |
tags |
array |
app tags
contains relevant app tags |