App Store API — iOS App Details, Search, Charts & Reviews

Everything the App Store shows about an iOS app as one clean JSON record: name, developer, price and currency, average rating and rating count (all versions and current version), version and release dates, release notes, description, genres, age rating, download size, minimum iOS, languages, icon and screenshots. Look up apps by id, bundle id or link, search by keyword, read the top-free and top-paid charts of any country — and, when you want them, the customer reviews with rating, title, text, version and date. Built on Apple's public, key-less lookup, search and RSS endpoints.

Try it in 1 minute:

1. Press Start — the prefilled input looks up two apps in the US store: Facebook (by id) and Instagram (by link).
2. Seconds later the Output tab shows both records with price, rating, version, size, genres, icon and screenshots.
3. Download JSON, CSV or Excel, or add Search queries, pick a Top chart, change the Country and switch Include reviews on.

Price: $0.80 per 1,000 apps (one app = one record, with its reviews included when you ask for them). Ids that do not exist, queries without matches and invalid inputs are free.

Use it to:

• Track competitors' apps on a schedule: version, release notes, rating and rating count, price changes, size — per country.
• Build a keyword-ranking report: which apps rank for "photo editor" in the US, DE and JP stores, with position and ratings.
• Pull the top-free and top-paid charts of a country every day for market research or a newsletter.
• Mine reviews for a product team or an AI summariser: the 500 newest or most helpful reviews per app and storefront, without reviewer names.
• Enrich a list of bundle ids or App Store links from your CRM or spreadsheet with structured app data.

How it works

1. Apps: ids, id123 forms, bundle ids and apps.apple.com links are parsed and deduplicated; numeric ids are looked up in batches of 100 with Apple's lookup endpoint (itunes.apple.com/lookup), bundle ids one by one. A link with its own storefront (/de/app/…) is looked up in that storefront.
2. Search queries go to Apple's search endpoint (itunes.apple.com/search?entity=software) with up to Max results apps per query (max 200), each with its position.
3. Top charts come from Apple's marketing feed (rss.marketingtools.apple.com/api/v2/<country>/apps/top-free|top-paid/…), which lists ids and names; the details are then fetched with one batched lookup, keeping the chart position. The public feed offers top-free and top-paid only — there is no public top-grossing feed.
4. Reviews (optional) come from Apple's public customer-reviews RSS feed, 50 per page, up to 10 pages (500 reviews) per app and storefront, newest or most helpful first. Reviewer names are not collected; phone numbers and e-mail addresses are removed from review text, descriptions and release notes.

Requests go directly to Apple (no proxy, unless a connection drops); Apple's per-IP rate limit on lookup and search (HTTP 403/429) is waited out and retried.

Input

Field	What it does
appIds	Apps to look up: numeric id, id123, bundle id or apps.apple.com link, one per line.
queries	Keywords to search, one per line.
charts	top-free and/or top-paid for the country.
country	Two-letter storefront (default us).
maxResults	Apps per query (up to 200) or chart (up to 100); default 25.
includeReviews	Add customer reviews to every app (default off).
maxReviews	Reviews per app, up to 500 (default 50).
sortBy	mostrecent (default) or mosthelpful.
maxConcurrency	Parallel requests (default 3 — Apple rate-limits per IP).
proxyConfiguration	Used only to retry after a network error; the first try is direct.

Output

One record per app:

Field	What it is
appId, bundleId, name, url	Identity and store page
developer, developerId, developerUrl, sellerName, sellerUrl	The business behind the app
price, currency, formattedPrice, isFree	Price in the storefront currency
rating, ratingCount, ratingCurrentVersion, ratingCountCurrentVersion	Average rating (0-5) and number of ratings, all versions and current version
version, releaseDate, currentVersionReleaseDate, releaseNotes	Versions and dates (ISO 8601)
description, genres[], primaryGenre, genreIds[], contentRating	What it is and for whom
size, minimumOsVersion, languages[], supportedDevicesCount	Technical facts (size in bytes)
icon, screenshots[], ipadScreenshots[]	Images
country, source, position	Storefront, where the record came from (lookup, search, chart) and its 1-based position in a query or chart
reviews[], reviewsError	{ id, rating, title, text, version, publishedAt, voteCount, voteSum } with Include reviews on; reviewsError says when the list stopped early
input, status, error, scrapedAt	What you gave, OK / NOT_FOUND / NO_RESULTS / INVALID_INPUT / FAILED, the reason, and when

Example

{
  "input": "https://apps.apple.com/us/app/instagram/id389801252",
  "source": "lookup",
  "appId": "389801252",
  "bundleId": "com.burbn.instagram",
  "name": "Instagram",
  "developer": "Instagram, Inc.",
  "developerId": "389801255",
  "developerUrl": "https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4",
  "url": "https://apps.apple.com/us/app/instagram/id389801252?uo=4",
  "price": 0,
  "currency": "USD",
  "formattedPrice": "Free",
  "isFree": true,
  "rating": 4.72,
  "ratingCount": 28401220,
  "ratingCurrentVersion": 4.72,
  "ratingCountCurrentVersion": 28401220,
  "version": "399.0",
  "releaseDate": "2010-10-06T07:00:00.000Z",
  "currentVersionReleaseDate": "2026-10-13T16:03:11.000Z",
  "releaseNotes": "Bug fixes and performance improvements.",
  "description": "Little moments lead to big friendships. Share yours on Instagram.",
  "genres": ["Photo & Video", "Social Networking"],
  "primaryGenre": "Photo & Video",
  "genreIds": ["6008", "6005"],
  "contentRating": "12+",
  "size": 348713984,
  "minimumOsVersion": "15.1",
  "languages": ["EN", "DE", "ES", "FR", "JA"],
  "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple/v4/11/22/33/icon/512x512bb.jpg",
  "screenshots": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource/v4/aa/bb/cc/shot1/392x696bb.png"],
  "ipadScreenshots": [],
  "supportedDevicesCount": 5,
  "sellerName": "Instagram, Inc.",
  "sellerUrl": "https://help.instagram.com/",
  "country": "us",
  "position": null,
  "reviews": [
    { "id": "12900000001", "rating": 5, "title": "Love the new update", "text": "Works great, reels load faster now.", "version": "399.0", "publishedAt": "2026-10-18T16:12:44.000Z", "voteCount": 4, "voteSum": 3 }
  ],
  "reviewsError": null,
  "status": "OK",
  "error": null,
  "scrapedAt": "2026-10-19T12:00:00.000Z"
}

FAQ

Is this an official API? No, it's an unofficial API built on public pages — Apple's public lookup, search and RSS endpoints, which need no key. The data is what the App Store itself shows; this Actor only shapes it into stable JSON records.

Why is an app NOT_FOUND? It is not sold in that storefront, it was removed, or the id is wrong. Try the storefront the app is actually published in (country), or give the apps.apple.com link with its country code.

How many reviews can I get? Apple's public feed exposes at most 10 pages of 50 reviews per app and storefront — 500 newest or 500 most helpful. For more, run the same app with both orders or in several countries. Reviewer names are deliberately not collected.

Can I get the top-grossing chart? Not from this Actor: Apple's public marketing feed offers top-free and top-paid only. The charts are per country and are refreshed by Apple roughly daily.

What about rate limits? Apple limits its lookup and search endpoints to roughly 20 calls a minute per IP. Lookups are batched 100 ids per call, and a 403/429 answer is waited out and retried, so a run of a few thousand apps simply takes a few minutes longer.

Like it? A short review on the Store page helps other people find this Actor. Something missing or broken? Tell us on the Issues tab — we read every one.

Related Actors

• Google Play Scraper — apps, search and reviews
• Website Tech Stack Detector — CMS, frameworks and analytics of any site
• Google News API — headlines by keyword and topic
• YouTube Channel API — channel stats and the latest videos
• News Search API — news by keyword with date range and full text