Crawlzodocs
API referenceApple App Store

App Store app

One app's App Store listing, with its ratings breakdown.

Address the app by app_id (Apple's numeric id, e.g. 310633997), by bundle_id (net.whatsapp.WhatsApp, costs one extra lookup to resolve), or by its full store url.

Returns title, subtitle, description, icon, screenshots and preview videos grouped by device, the developer block (name, id, website, support and privacy-policy URLs), the exact rating plus the full 1-5 star histogram, rating and review counts, price, the itemised in-app purchase list with prices, content rating and advisories, genres, release and update dates, the version history with release notes, download size, minimum OS, supported languages and devices, and the store's own related-app rails.

Two things Apple does not publish, which are therefore absent rather than faked: an ISO currency code on this surface (the storefront gives a formatted price only, and `--- description: "One app's App Store listing, with its ratings breakdown." title: "App Store app" full: true _openapi: preload:

  • ./openapi/crawlzo.json method: POST webhook: false toc: [] structuredData: headings: [] contents:
    • content: >- Address the app by app_id (Apple's numeric id, e.g. 310633997), by

      bundle_id (net.whatsapp.WhatsApp, costs one extra lookup to resolve),

      or by its full store url.

      Returns title, subtitle, description, icon, screenshots and preview videos

      grouped by device, the developer block (name, id, website, support and

      privacy-policy URLs), the exact rating plus the full 1-5 star histogram,

      rating and review counts, price, the itemised in-app purchase list with

      prices, content rating and advisories, genres, release and update dates, the

      version history with release notes, download size, minimum OS, supported

      languages and devices, and the store's own related-app rails.

      Two things Apple does not publish, which are therefore absent rather than

      faked: an ISO currency code on this surface (the storefront gives a formatted

      price only, and $ is four different currencies across these stores, the

      search and developer endpoints do carry currency), and an install count,

      which Apple has never exposed for any app.

      An app that is not sold in the requested country is a clean 404, that means

      "not available in country", which is not the same as "does not exist".

      The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.0s.


is four different currencies across these stores, the search and developer endpoints do carry currency), and an install count, which Apple has never exposed for any app.

An app that is not sold in the requested country is a clean 404, that means "not available in country", which is not the same as "does not exist".

The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.0s.

POST
/v1/scrapers/app-store-app-v4

Authorization

ApiKeyAuth
X-API-Key<token>

Your API key. Sent on every request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/scrapers/app-store-app-v4" \  -H "Content-Type: application/json" \  -d '{    "app_id": "310633997",    "country": "US"  }'
{  "request_id": "req_8f2c1d94e7b0",  "success": true,  "status": {    "code": "OK",    "message": "Scrape completed.",    "retryable": false  },  "data": {    "advisories": [      "Infrequent/Mild Profanity or Crude Humor",      "Infrequent/Mild Horror/Fear Themes",      "… 2 more items in the full response"    ],    "app_id": "310633997",    "bundle_id": "net.whatsapp.WhatsApp",    "content_rating": "12+",    "copyright": "© 2026 WhatsApp LLC",    "country": "US",    "customers_also_bought": [      "454638411",      "686449807",      "… 12 more items in the full response"    ],    "description": "WhatsApp from Meta is a free messaging and calling app used by over 2 billion people across 180+ countries. It's super simple, reliable and private, making it perfect for staying in touch with your friends and family worldwide. WhatsApp works across mobile, tablet, and desktop even on slow connections, with no subscrip… (+2062 chars)",    "developer": {      "eula": "https://itunes.apple.com/WebObjects/MZStore.woa/wa/viewEula?cc=us&id=310633997",      "id": "310634000",      "name": "WhatsApp Inc.",      "privacy_policy": "https://www.whatsapp.com/legal/#Privacy",      "support_url": "http://www.whatsapp.com/faq/",      "url": "https://apps.apple.com/us/developer/whatsapp-inc/id310634000",      "website": "http://www.whatsapp.com/"    },    "device_families": [      "mac",      "watch",      "… 3 more items in the full response"    ],    "free": true,    "genre": "Social Networking",    "genre_ids": [      "6005",      "6002"    ],    "genres": [      "Social Networking",      "Utilities"    ],    "histogram": {      "1": 628445,      "2": 248813,      "3": 558477,      "4": 1436223,      "5": 15583111    },    "icon": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/7d/a4/c8/7da4c802-e8e6-7b68-5588-3b2e8bd808c6/Placeholder.mill/512x512bb.jpg",    "in_app_purchase_items": [      {        "name": "No ads (1 account)",        "price": "$4.00"      },      {        "name": "No ads (13 accounts)",        "price": "$66.99"      },      "… 8 more items in the full response"    ],    "in_app_purchases": true,    "kind": "iosSoftware",    "languages": [      "English",      "Arabic",      "… 37 more items in the full response"    ],    "minimum_os_version": "15.1",    "more_by_developer": [      "1386412985"    ],    "price": 0,    "price_formatted": "$0.00",    "rating": 4.685,    "rating_count": 18455069,    "release_notes": "We update the app regularly to fix bugs, optimize performance and improve the experience. Thanks for using WhatsApp!",    "released_at": "2009-05-04T00:00:00+00:00",    "requirements": "Requires iOS 15.1 and watchOS 10.0 or later. Compatible with iPhone, iPad, and iPod touch.",    "review_count": 198727,    "screenshots": {      "apple_watch": [        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/39/9a/01/399a01e6-bf86-c8ac-219d-111e1b0b7690/en_US01.png/1024x1221bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/46/bf/76/46bf763d-32f3-8f5b-81ba-d55d79b5ca79/en_US02.png/1024x1221bb.jpg",        "… 3 more items in the full response"      ],      "ipad": [        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/9a/1e/81/9a1e818a-c375-e0fb-2f15-9b57a72cacca/1_ipad13.png/1024x768bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/48/8e/0e/488e0e29-a4f6-37aa-8c08-fa501b5fbf31/2_ipad13.png/1024x768bb.jpg",        "… 3 more items in the full response"      ],      "iphone": [        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/d8/95/88/d89588dd-ce20-0f5b-95bc-f99814bf9a6c/6.9__Display_1-en_US.png/1024x2219bb.jpg",        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/60/0f/39/600f39e2-82c1-d2dd-eb76-d9c58d88e1f9/6.9__Display_2-en_US.png/1024x2219bb.jpg",        "… 3 more items in the full response"      ]    },    "size_bytes": 392140800,    "subtitle": "Simple. Reliable. Private.",    "supports_apple_watch": true,    "supports_siri": true,    "title": "WhatsApp Messenger",    "updated_at": "2026-08-18T21:20:19+00:00",    "url": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997",    "version": "26.32.75",    "version_history": [      {        "release_notes": "We update the app regularly to fix bugs, optimize performance and improve the experience. Thanks for using WhatsApp!",        "released_at": "2026-08-18T21:20:19+00:00",        "version": "26.32.75"      },      {        "release_notes": "We update the app regularly to fix bugs, optimize performance and improve the experience. Thanks for using WhatsApp!",        "released_at": "2026-08-17T14:39:15+00:00",        "version": "26.32.73"      },      "… 23 more items in the full response"    ]  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "app-store-app-v4",    "billable": true,    "duration_ms": 2415  }}