App Store Metadata & Charts

Fetches app metadata from Apple's official itunes.apple.com/lookup and RSS chart endpoints, and Google Play's public app page. No reviews, no reviewer names — just app-level facts.

Input

Field	Type	Required	Notes
mode	lookup | chart	yes	lookup = metadata for specific apps. chart = a top chart (Apple only).
platform	apple | play	yes	chart mode only supports apple — Play has no public chart endpoint.
appIds	string[]	for lookup	Apple numeric track ids (e.g. 284882215) or Play package names (e.g. com.facebook.katana).
country	string	no	Two-letter store country code, default us.
chart	string	for chart	Apple RSS chart id, e.g. topfreeapplications, toppaidapplications, topgrossingapplications. Default topfreeapplications.
limit	integer	for chart	Number of chart rows to fetch. Default 25.

Output

One dataset row per app (lookup) or per chart position (chart).

Apple lookup row (real output, id=284882215):

{
    "platform": "apple",
    "appId": "284882215",
    "bundleId": "com.facebook.Facebook",
    "title": "Facebook",
    "developer": "Meta Platforms, Inc.",
    "category": "Social Networking",
    "price": 0,
    "currency": "USD",
    "version": "576.0.0",
    "releaseNotes": "Our teams have solved many crashes, fixed issues you've reported and made the app faster.",
    "sizeBytes": "499631104",
    "ratingValue": 4.52536,
    "ratingCount": 28120782,
    "screenshotUrls": ["https://is1-ssl.mzstatic.com/..."],
    "country": "us",
    "fetchedAt": "2026-09-02T00:47:37.682Z"
}

Apple chart row (real output, topfreeapplications, US, rank 1):

{
    "platform": "apple",
    "rank": 1,
    "country": "us",
    "chart": "topfreeapplications",
    "appId": "316126557",
    "bundleId": "com.aol.mapquest",
    "title": "MapQuest GPS Navigation & Maps",
    "developer": "MapQuest Holdings LLC",
    "category": "Navigation",
    "price": "Get",
    "date": "2026-09-02"
}

Play lookup row (real output, com.facebook.katana):

{
    "platform": "play",
    "appId": "com.facebook.katana",
    "title": "Facebook",
    "developer": "Meta Platforms, Inc.",
    "category": "SOCIAL",
    "price": "0",
    "ratingValue": 4.559006690979004,
    "ratingCount": 185448370,
    "installsText": "10B+",
    "version": null,
    "jsonLd": { "...": "full schema.org SoftwareApplication block, when Play includes it" },
    "country": "us",
    "fetchedAt": "2026-09-02T00:47:28.497Z"
}

Pricing

Pay-per-event:

• app-scraped — $0.00029 per app row (Apple or Play lookup).
• rank-row — $0.00085 per chart row.

Never charged on an empty result.

Limits / known gaps

• Play version is not present in the static HTML since Google's page redesign (it now lives behind a JS-hydrated data blob we don't parse — that blob also contains individual review text/authors interleaved with app data, which we deliberately never touch). Field is always null for Play rows.
• Play installsText is the abbreviated label shown on the page (e.g. "10B+"), not an exact count — Play stopped publishing an exact number.
• Play jsonLd is null when Google omits the schema.org block for a given app/locale (observed present for major apps, not guaranteed for all).
• Apple price in chart rows is the store's own button label ("Get" for free, "$X.XX" for paid) rather than a normalized number — mirrors the RSS feed's own format.
• No proxy is used. Apple's endpoints are unthrottled JSON APIs; Play is a single unauthenticated page fetch per app. Very high volume against Play may eventually get rate-limited — no retry/backoff is implemented beyond what got-scraping does by default.