Apple App Store
App Store App Details API
Look up one Apple App Store listing as JSON by App Store id OR bundle id: title and description, developer and seller identity, price and currency for the storefront you ask for, all-time and current-version ratings, version and release notes, genres, content rating and advisories, icons at three sizes, iPhone/iPad/Apple TV screenshots, download size, minimum OS, languages, supported devices, and the Game Center and volume-purchase flags. Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonapp_idstringrequiredEither a numeric App Store id — the digits after `id` in an apps.apple.com URL — or the app's bundle id (notion.id, com.burbn.instagram). Both are auto-detected and resolve to the identical payload, so you never need a lookup step to go from bundle id to App Store id. 1-255 characters matching ^[A-Za-z0-9][A-Za-z0-9._-]*$: a pasted apps.apple.com URL is rejected with a FREE 400 rather than forwarded, because an identifier Apple cannot resolve is a BILLED 404 (Apple charges for the 200 that carries an empty result list).
Example: 1232780281
countrystringdefault:usTwo-letter ISO storefront code. Decides price, currency, formatted_price, the localised title and description, and whether the app is listed in that market at all. Must be exactly two letters — "usa" or "united states" is a free 400 rather than a silent US result set, because the transport underneath falls back to US for anything else.
Example: gb
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Numeric App Store id or bundle id - same payload either way.
app = client.app_store.app("1232780281")["data"]
same = client.app_store.app("notion.id")["data"]
print(app["title"], app["version"], app["rating"], app["rating_count"])
print(app["current_version_release_date"], app["release_notes"])
# Price is per storefront - ask each market you sell in.
uk = client.app_store.app("1232780281", country="gb")["data"]
print(uk["formatted_price"], uk["currency"])Response