DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live Apple App Listings Search Results
Searches DataForSEO's own index of App Store listings, synchronously - the Apple twin of post_dataforseo_app_google_app_listings_search_live, same arguments and same shape. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Category names come from get_dataforseo_app_apple_app_listings_categories.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array (object | null)[]
- categoriesType: array string[] | null
- descriptionType: string | null
keyword in the app's description
optional field
keywords that occur in the description of the app;
can contain up to 200 characters - filtersType: array (object | null)[] | null
array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operatorand,orbetween the conditions
the following operators are supported:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
you can use the%operator withlikeandnot_liketo match any string of zero or more characters
example:["rating.value",">",3]you can receive the list of available filters_by making a separate request to
https://api.dataforseo.com/v3/app_data/apple/app_listings/available_filtersnEmpty object - limitType: integer | null
the maximum number of returned apps
optional field
default value:100
maximum value:1000 - offsetType: integer | null
offset in the results array of returned apps
optional field
default value:0
if you specify the10value, the first ten entities in the results array will be omitted and the data will be provided for the successive entities
Note: we recommend using this parameter only when retrieving up to 10,000 results
for retrieving over 10,000 results, use theoffset_tokeninstead. - offsetType: string | null
_token token for subsequent requests
optional field
provided in the identical filed of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;
by specifying the uniqueoffset_tokenvalue from the response array, you will get the subsequent results of the initial task;offset_tokenvalues are unique for each subsequent task
Note: if theoffset_tokenis specified in the request, all other parameters should be identical to the previous request
learn more about this parameter on our Help Center - orderType: array string[] | null
_by results sorting rules
optional field
you can use the same values as in thefiltersarray to sort the results
possible sorting types:asc- results will be sorted in the ascending orderdesc- results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:["item.rating.value,desc"]note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:["item.rating.value,desc","item.rating.value,desc"] - tagType: string | null
user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specifiedtagvalue in thedataobject of the response - titleType: string | null
keyword in the app's title
optional field
keywords that occur in the title of the app;
can contain up to 200 characters
- Type: object | null · Response36Afe1097B20_AppDataAppleAppListingsSearchLiveResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_AppDataAppleAppListingsSearchLiveTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- countType: integer | null Format: int64
the number of items in the results array
- itemsType: array (object | null)[] | null
array of apps and related data
- appType: string | null
_id ID of the returned app
- checkType: string | null
_url direct URL to search engine results
you can use it to make sure that we provided accurate results - itemType: object | null · Response36Afe1097B20_AppStoreInfoOrganic
detailed information about the app
- advisoriesType: array (string | null)[] | null
age rating and age-based content advisories
- appType: string | null
_id ID of the app
- categoriesType: array (string | null)[] | null
all relevant categories/genres of the app
Note: this field returns only one relevant category in the array - descriptionType: string | null
description of the app
- developerType: string | null
name of the app developer
- developerType: string | null
_id ID of the app developer
- developerType: string | null
_url URL to the developer page on App Store
- iconType: string | null
URL to the app icon
- imagesType: array (string | null)[] | null
app images
contains URLs to the images used on the app page on App Store - isType: boolean | null
_free indicates whether the app is free
- languagesType: array (string | null)[] | null
languages supported in the app
Note: this field returns only one supported language in the array - lastType: string | null
_update _date 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 - mainType: string | null
_category main category/genre of the app
- minimumType: string | null
_os _version minimum OS version required to install the app
- moreType: array (object | null)[] | null
_apps _by _developer similar apps
information about apps built by the same developer- appType: string | null
_id ID of the app
- titleType: string | null
title of the app
- urlType: string | null
URL to the app page on Google Play
- positionType: string | null
the alignment of the element in SERP
can take the following values:left - priceType: object | null · Response36Afe1097B20_PriceInfo
price of the app
- currencyType: string | null
currency of the listed price ISO code of the currency applied to the price
- currentType: number | null Format: double
current price indicates the current price of the product or service featured in the result
- displayedType: string | null
_price price string in the result raw price string as provided in the result
- isType: boolean | null
_price _range price is provided as a range indicates whether a price is provided in a range
- maxType: number | null Format: double
_value the maximum price the maximum price of the product or service as indicated in the result
- regularType: number | null Format: double
regular price indicates the regular price of the product or service with no discounts applied
- rankType: integer | null
_absolute absolute rank among all the listed apps
absolute position among all apps on the list - rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted fromrank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
average rating of the app
- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- releasedType: string | null
_date 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
Note: this field is deprecated and always returnsnull - reviewsType: integer | null Format: int64
_count the total number of reviews of the app
- similarType: array (object | null)[] | null
_apps similar apps
displays apps similar to the app in a POST request- appType: string | null
_id ID of the app
- titleType: string | null
title of the app
- urlType: string | null
URL to the app page on Google Play
- sizeType: string | null
size of the app
- subtitleType: string | null
subtitle of the app
- titleType: string | null
title of the app
- typeType: string | null
type of element
- updateType: string | null
_notes update notes
contains the latest update notes from the developer - urlType: string | null
URL to the app page on App Store
- versionType: string | null
current version of the app
- languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- seType: string | null
_domain search engine domain in a POST array
- timeType: string | null
_update
- offsetType: integer | null
offset in the results array of returned apps
- offsetType: string | null
_token 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 - totalType: integer | null Format: int64
_count the total number of relevant results in the database
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code 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
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_listings/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"title": "vpn",
"description": "vpn",
"categories": [
"Utilities"
],
"order_by": [
"item.rating.value,desc"
],
"filters": [
[
"item.rating.value",
">",
4.5
]
],
"limit": 10
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"total_count": null,
"count": null,
"offset": null,
"offset_token": null,
"items": [
{
"app_id": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"time_update": null,
"item": "[Max Depth Exceeded]"
}
]
}
]
}
]
}