GET/appstore/appapiKey1 credit/request
Returns app metadata from the App Store. Provide either `id` (numeric track ID) or `app_id` (bundle ID). `id`/`app_id` can identify an iPhone, iPad, or Mac App Store listing.
Optional: id, app_id, country, lang, ratings, platforms.
Sampled 14 Oct 2026: 32 fields returned with a value, 1 empty (appletv_screenshots). In the sample: released: 2023-05-18; size: 271,727,616; title: “ChatGPT”; url: apps.apple.com; free: true; description: 1,339 characters; genres: 2 entries; icon: is1-ssl.mzstatic.com.
Open in Playground
GET/appstore/categoriesapiKey1 credit/request
Returns every category ID and chart collection accepted by `/appstore/list`, including Games and Magazines & Newspapers subgenres with their parent ID. Collections carry their device platform (`phone`, `pad`, `mac`), chart type (`top_free`, `top_paid`, `top_grossing`, `top`, `new`), and whether the feed currently returns entries.
Takes no parameters.
Sampled 14 Oct 2026: 13 items. Filled in every item: id, platform, chart_type, active. In the sample: platform: phone (6), mac (4), pad (3); active: true in 10 of 13; chart_type: top_free (3), top_paid (3), top_grossing (3) and 2 more.
Open in Playground
GET/appstore/collectionapiKey1 credit/request
Returns app items embedded in an Apple room or EDS collection page. Discover IDs with `appstore_collections`. `platform` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`. `collection_id` must be a numeric room ID or `eds.UUID` ID returned by the discovery endpoint.
Required: platform (6 allowed values: iphone, ipad, mac, vision, watch, tv), collection_id. Optional: country, lang.
Sampled 14 Oct 2026: 41 items. Filled in every item: kind, id, bundle_id, title, subtitle, developer_name, age_rating, rating and 3 more. In the sample: age_rating: 12+ (22), 17+ (9), 4+ (8) and 1 more; rating: 4.2 to 5, median 4.7; title: “TikTok - Videos, Shop & LIVE” and 40 other values; icon_url: is1-ssl.mzstatic.com; subtitle: “Watch, discover and stream!” and 40 other values; developer_name: “TikTok Ltd.” and 38 other values; url: apps.apple.com.
Open in Playground
GET/appstore/collectionsapiKey1 credit/request
Returns the room and EDS collection links embedded in Apple's browse page for one device. `platform` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`. Pass a returned `id` and the same platform to `appstore_collection` to retrieve the collection's apps.
Required: platform (6 allowed values: iphone, ipad, mac, vision, watch, tv). Optional: country, lang.
Sampled 14 Oct 2026: 15 items. Filled in every item: id, kind, platform, title, url. In the sample: title: “Apps in Heavy Rotation” and 14 other values; url: apps.apple.com.
Open in Playground
GET/appstore/developer/{dev_id}apiKey1 credit/request
Lists the App Store apps published by one developer, by Apple developer (artist) id, for an optional storefront country and language. Each app carries its id, title, description, icon and screenshots, price and currency, genres, version and release notes, rating score and counts, size, supported devices and languages.
Required: dev_id. Optional: country, lang.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, app_id, title, url, description, icon, genres, genre_ids and 24 more. Not in every item: appletv_screenshots (0). In the sample: released: 2023-05-18 to 2026-05-04; size: 271,727,616 to 315,488,256, median 271,727,616; title: “ChatGPT” and 1 other value; url: apps.apple.com; free: true in 2 of 2; description: median 1,232 characters; genres: median 2 entries; icon: is1-ssl.mzstatic.com.
Open in Playground
GET/appstore/editorialapiKey1 credit/request
Returns the curated editorial shelves from one of Apple's per-device App Store landing pages (the same content shown by apps.apple.com's device switcher). `device` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`. `section` enum: `main` (the device's Today/Discover/Apps & Games landing page), `arcade` (the device's Apple Arcade landing page). Watch has no Arcade page — `device=watch` with `section=arcade` returns `400`.
Required: device (6 allowed values: iphone, ipad, mac, vision, watch, tv). Optional: section (2 allowed values: main, arcade), country, lang.
Sampled 14 Oct 2026: 29 items. Filled in every item: content_type, items. Not in every item: id (28), title (25). In the sample: content_type: “heroCarousel” and 9 other values; title: median 27 characters; items: median 10 entries.
Open in Playground
GET/appstore/editorial/categoryapiKey1 credit/request
Returns the curated editorial shelves for one device category page (e.g. "Entertainment Apps for Vision"). `category_id` is a numeric, device-specific editorial page ID — not a static enum — discovered from an `appstore_editorial` response for the SAME `device`, in its "Browse by Category" shelf items' `destination_id` field. `device` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`.
Required: device (6 allowed values: iphone, ipad, mac, vision, watch, tv), category_id. Optional: country, lang.
Sampled 14 Oct 2026: 8 items. Filled in every item: content_type, items. Not in every item: id (7), title (6). In the sample: content_type: “heroCarousel” and 4 other values; title: median 27 characters; items: median 8 entries.
Open in Playground
GET/appstore/listapiKey1 credit/request
Returns ranked App Store apps from an iTunes RSS collection, optionally expanded to full lookup details. `collection` enum: `topfreeapplications`, `toppaidapplications`, `topgrossingapplications`, `topfreeipadapplications`, `toppaidipadapplications`, `topgrossingipadapplications`, `topmacapps`, `topfreemacapps`, `topgrossingmacapps`, `toppaidmacapps`, `newapplications`, `newfreeapplications`, `newpaidapplications`. Of the Mac collections, only `topfreemacapps` currently returns ranked apps — `topmacapps`, `topgrossingmacapps`, and `toppaidmacapps` are accepted but Apple's feed for them is currently empty. There is no separate Games `collection` — combine any collection with `category=6014` (or a Games subgenre ID, e.g. `7012` for Puzzle) to get its Games-only equivalent, e.g. Top Free Games. See the endpoint markdown for the full category ID table.
Optional: collection, category, country, lang, num, full_detail.
Sampled 14 Oct 2026: 40 items. Filled in every item: id, app_id, title, icon, url, price, currency, free and 7 more. In the sample: released: 2008-12-03 to 2026-09-08; title: “Muse from Meta” and 39 other values; icon: is1-ssl.mzstatic.com; free: true in 40 of 40; description: median 2,201 characters; url: apps.apple.com; developer: “Meta Platforms, Inc.” and 29 other values; developer_url: apps.apple.com.
Open in Playground
GET/appstore/privacy/{id}apiKey1 credit/request
Returns the privacy disclosures shown on an App Store page for one app, identified by its numeric track `id` (digits only; anything else returns 400). The response has `privacy_policy_url`, `manage_privacy_choices_url` and `privacy_types`, each with its data categories and purposes. `country` and `lang` are optional.
Required: id. Optional: country, lang.
Sampled 14 Oct 2026: 1 item. Not in every item: privacy_type (0), identifier (0), description (0), data_categories (0), purposes (0).
Open in Playground
GET/appstore/ratingsapiKey1 credit/request
Returns the total `ratings` count and the 1 to 5 star `histogram` for an App Store app. Identify it with either the numeric track `id` or the bundle ID `app_id`; a bundle ID is resolved to the track ID first, and a non-numeric `id` returns 400. `country` and `lang` are optional.
Optional: id, app_id, country, lang.
Sampled 14 Oct 2026: 2 fields returned with a value. In the sample: ratings: 11,243,559.
Open in Playground
GET/appstore/reviewsapiKey3 credits/request
Returns one page of customer reviews for an App Store app, identified by `id` (numeric track ID) or `app_id` (bundle ID). `page` runs 1 to 10 and `sort` is `mostRecent` (default) or `mostHelpful`. Reviews carry `score`, `title`, `text`, `version`, `user_name` and `updated`. Returns 503 when reviews cannot be retrieved, and 404 when the app is not in that `country` storefront.
Optional: id, app_id, country, page, sort (2 allowed values: mostRecent, mostHelpful), lang.
Sampled 14 Oct 2026: 50 items. Filled in every item: id, user_name, user_url, version, score, title, text, url and 1 more. In the sample: updated: 2026-10-11 to 2026-10-12; score: 1 to 5, median 5; user_url: itunes.apple.com; url: itunes.apple.com.
Open in Playground
GET/appstore/searchapiKey1 credit/request
Returns App Store search results for a term. Set `ids_only=true` to return only app IDs. `platform` enum: `phone`, `pad`, `mac`.
Required: term. Optional: num, page, country, lang, ids_only, platform (3 allowed values: phone, pad, mac).
Sampled 14 Oct 2026: 30 items. Filled in every item: id, app_id, title, url, description, icon, genres, genre_ids and 21 more. Not in every item: release_notes (29), developer_website (23), ipad_screenshots (24), appletv_screenshots (0). In the sample: released: 2010-10-06 to 2026-09-08; primary_genre: Productivity (24), Photo & Video (2), Utilities (1) and 3 more; size: 4,205,568 to 808,836,096, median 182,049,792; title: “ChatGPT” and 29 other values; url: apps.apple.com; free: true in 30 of 30; description: median 2,362 characters; genres: median 2 entries.
Open in Playground
GET/appstore/similarapiKey1 credit/request
Returns the related apps shown on the App Store product page. Provide either `id` (numeric track ID) or `app_id` (bundle ID).
Optional: id, app_id, country, lang.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, app_id, title, url, description, icon, genres, genre_ids and 23 more. Not in every item: ipad_screenshots (9), appletv_screenshots (0). In the sample: released: 2021-05-11 to 2025-01-08; content_rating: 12+ (5), 17+ (3), 4+ (2); size: 136,676,352 to 808,836,096, median 182,049,792; title: “Grok AI” and 9 other values; url: apps.apple.com; free: true in 10 of 10; description: median 2,827 characters; genres: median 2 entries.
Open in Playground
GET/appstore/suggest/{term}apiKey1 credit/request
Returns App Store search suggestions for a partial search term given in the path, as a list of suggested `term` values. `country` is an optional two-letter storefront code.
Required: term. Optional: country.
Sampled 14 Oct 2026: 10 items. Filled in every item: term. In the sample: term: “chatgpt” and 9 other values.
Open in Playground
GET/appstore/version-history/{id}apiKey1 credit/request
Returns an App Store app's version history, as shown under "What's New", by numeric track id, for an optional storefront country and language. Each entry has the version number, release date and timestamp, and release notes. A non-numeric id returns `400`.
Required: id. Optional: country, lang.
Sampled 14 Oct 2026: 25 items. Filled in every item: version_display, release_notes, release_date, release_timestamp. In the sample: release_date: 2026-05-11 to 2026-10-06; release_timestamp: 2026-05-11 to 2026-10-06.
Open in Playground