App Store Search, Rank & App Details — No Login
Pricing
from $0.75 / 1,000 app rows
Search the Apple App Store for many keywords in many countries in one run, with exact rank per term, or look up apps by App ID, bundle ID or URL. Ratings, price, version, developer and genres from Apple's official API. No login, no API key.
status
Required
Row result: complete (app data), not_found (search with no apps, or ID/bundle ID not in that country's store) or error (see errorCode). Only complete rows are charged.
mode
Required
search or lookup.
queryType
Required
What the row answers: term (keyword search), appId or bundleId (lookup).
query
Required
Your search term, App ID or bundle ID exactly as processed. A grouped status row lists all IDs or terms it covers, separated by commas (see queryIds).
queryIds
Required
Only on grouped status rows: the IDs (or search terms) this one row covers. Used for lookup not_found/error rows (one row per batch of up to 100 IDs in one country) and for the one row that lists queries not sent to a country Apple rejected. null on app rows and normal search rows.
term
Required
Search term (search mode); null for lookups.
country
Required
Two-letter App Store country (storefront) code, e.g. us, de.
entity
Required
App type searched: software (iPhone), iPadSoftware or macSoftware; null for lookups.
rank
Required
1-based position in the iTunes Search API results for this term and country (deduplicated). Close to, but not guaranteed identical to, the App Store app's own search order. Null for lookups.
isTracked
Required
True when this app is one of your trackAppIds; null when no apps are tracked.
trackId
Required
Apple App ID (the number in the App Store URL after 'id').
bundleId
Required
Bundle identifier, e.g. com.adobe.scan.ios.
name
Required
App name in this country's store.
kind
Required
Apple kind: software or mac-software.
sellerName
Required
Legal seller name shown on the App Store.
developerName
Required
Developer (artist) name.
developerId
Required
Apple developer ID.
developerUrl
Required
Developer page on the App Store.
sellerUrl
Required
Developer website, when the app lists one.
price
Required
Upfront price in the store currency; 0 for free apps. In-app purchases are not included.
formattedPrice
Required
Price as Apple displays it, e.g. Free or $4.99.
currency
Required
ISO currency of the price, e.g. USD.
primaryGenre
Required
Primary category, e.g. Productivity.
primaryGenreId
Required
Apple genre ID of the primary category.
genres
Required
All categories listed for the app.
averageUserRating
Required
Average star rating (0–5) in this country across all versions. Null when the app has no ratings yet (userRatingCount 0) or Apple returns none.
userRatingCount
Required
Number of ratings in this country across all versions.
averageUserRatingCurrentVersion
Required
Average rating for the current version, as Apple reports it; null when the current version has no ratings.
userRatingCountCurrentVersion
Required
Number of ratings for the current version, as Apple reports it.
version
Required
Current version string.
releaseDate
Required
Original release date (ISO 8601).
currentVersionReleaseDate
Required
Release date of the current version (ISO 8601).
fileSizeBytes
Required
Download size in bytes.
contentRating
Required
Age rating, e.g. 4+ or 12+.
minimumOsVersion
Required
Minimum OS version required.
languages
Required
Supported languages as Apple lists them (ISO 639-1, upper case; Apple sometimes repeats a code, e.g. ZH for both Chinese variants).
supportedDevicesCount
Required
Number of supported device models Apple lists.
url
Required
App Store page URL.
iconUrl
Required
App icon (512 px when available).
screenshotUrls
Required
iPhone (or Mac) screenshot URLs.
ipadScreenshotUrls
Required
iPad screenshot URLs.
description
Required
Full App Store description; only when includeDescription is on, otherwise null.
releaseNotes
Required
What's New text of the current version; only when includeDescription is on.
errorCode
Required
Machine code for error rows: INVALID_IDENTIFIER, SOURCE_BAD_REQUEST (country not supported), RATE_LIMITED, SOURCE_UNAVAILABLE, SOURCE_TIMEOUT, SOURCE_SCHEMA_CHANGED, NOT_PROCESSED. Null otherwise.
errorMessage
Required
Plain-English reason for an error row.
source
Required
Always apple-itunes-search-api.
sourceUrl
Required
The exact iTunes Search/Lookup API request behind this row; empty for rows that were not sent to Apple (invalid identifiers, queries skipped after a rejected country).
fetchedAt
Required
When the row was fetched (ISO 8601, UTC).
