Apps
The Apps endpoint returns app metadata for the requested app IDs.
Fields can be absent or null when unavailable. Store-specific fields and the JSON type of an ID can vary between lookup, discovery, and bulk export responses.
| Attribute | Description |
|---|---|
id |
string in app lookups; Apple App Store IDs can be integers in discovery and bulk exports. Google Play IDs are package-name strings. |
name |
string, app name |
description |
string, app description |
category_id |
integer, primary category id, app store specific |
subcategory_id |
integer, primary subcategory id, if present, app store specific |
category_name |
string, primary category name, app store specific |
subcategory_name |
string, primary subcategory name, app store specific |
category_ids |
list of integer, all app category ids, app store specific |
price_cents |
integer, app price in cents |
offers_in_app_purchases |
boolean, true if app offers IAPs |
app_store_url |
string, url to app store app page |
publisher_name |
string, name of app’s publisher |
publisher_id |
integer, id of app’s publisher |
publisher_url |
string, optional url to publisher site, provided by publisher |
initial_release_date |
date, date of initial release |
current_version |
string, current version slug |
last_update_date |
date, date of last tracked version update |
approx_size_bytes |
integer or null, approximate app size in bytes; availability varies by store and endpoint |
icon_url |
string, url for app icon, app store CDN |
screenshot_urls |
array of strings, urls for app screenshots, app store CDN |
other_stores |
optional, array of maps, contains inter-store links, e.g. "other_stores": [{"store": "google_play", "id": "com.king.candycrushsaga"}] |
bundle_id |
iTunes only, returns app’s bundle ID defined by Apple |
permissions |
array with app permissions as strings or null, e.g. ["view network connections","full network access"] |
apptopia_url |
string, a URL to an App information page on apptopia.com |
privacy_url |
string, a URL to an App Privacy Policy page, scraped from App Store |
subtitle |
string or null, app subtitle or short description |
age_restrictions |
string or null, store-provided age restriction |
cross_store_app_id |
integer or null, Apptopia identifier connecting app records across stores |
cross_store_publisher_id |
integer or null, Apptopia identifier connecting publisher records across stores |
parent_company_id |
integer or null, associated parent company ID |
icons |
optional object mapping image sizes such as 128x128 to icon URLs; present in app lookup responses |
languages |
Apple App Store only, array of language strings or null |
compatible_ios |
Apple App Store only, string or null describing iOS compatibility |
operating_systems |
Google Play only, string or null describing operating system compatibility |
vnd_estimated_installs |
Google Play only, string or null containing the store-provided install range |
interactive_elements |
Google Play only, optional array of interactive-element labels |
App ids are app store specific, Apple App Store exposes numeric ids, e.g. “553834731” for Candy Crush Saga. Google Play uses app package names for ids, e.g. "com.king.candycrushsaga" for the same app.
Dates are strings in ISO-8601 format, i.e.: "YYYY-MM-DD".