← All site APIs · updated 2026-09-21

App Store app API

apps.apple.com · 1 credit when fetched live, 0 from the shared store · needs an API key

An iOS app by id as JSON: name, developer, rating, price, category, screenshots and description.

GET /v1/structured/appstore/app

App by id. The listing page as JSON.

ParameterTypeRequiredDescription
idstringyesThe numeric app id (the id… part of the URL). e.g. 284882215
countrystringnoStorefront country code. Default us. e.g. us
max_agenumbernoAccept a stored copy up to this many seconds old (credits: 0). Defaults to 86400 s (24 h); 0 forces a fresh fetch.
Example
curl "https://api.webscrapingapi.dev/v1/structured/appstore/app?id=284882215&country=us" -H "X-API-Key: wsa_your_key"
Response
{
  "site": "appstore",
  "action": "app",
  "data": {
    "app": {
      "name": "Facebook",
      "platform": "ios",
      "id": "284882215",
      "developer": { "name": "Meta Platforms, Inc.", "url": "https://apps.apple.com/us/developer/…" },
      "category": "Social Networking",
      "price": "0", "currency": "USD", "free": true,
      "rating": { "value": 4.5, "count": 28420068 },
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/…png",
      "osRequirement": "Requires iOS 15.1 or later."
    }
  },
  "source": "live", "age": 0, "credits": 1
}

Returns data shaped like: { app: { name, url, platform: "ios", id, developer { name, url }, description, category, price, currency, free, rating { value, count }, icon, screenshots[], contentRating, osRequirement, installs: null, updatedAt, version } }. The envelope also carries site, action, params, source (live or cache), age in seconds, fetchedAt, elapsedMs and credits.

Caching. Results are stored and shared for 24 h by default. A response served from the store costs 0 credits and says "source": "cache"; pass max_age=0 to force a fresh fetch, or a smaller max_age when you need something newer.


Layout changes on apps.apple.com can break parsing; the API then returns SITE_PARSE_FAILED. If you see it, tell us on the board and it will be fixed.