Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · App stores

    app_store.app

    One app's page on Apple's App Store for a country: developer, category, rating, price, description, version and images.

    Id
    app_store.app
    Version
    1
    Billed per
    request — 1 unit for a charged run
    Runs
    within one request

    Start it with POST /v1/scrapers/app_store.app/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.

    Inputs

    The fields of input. A field that is not listed here is refused.

    Inputs of app_store.app
    FieldTypeDescription
    app_idstringApple's numeric app id, e.g. 310633997 (the digits after "id" in the app's address).Limit: matches ^(id)?[0-9]{1,20}$.
    urlstringThe app's address, e.g. https://apps.apple.com/us/app/whatsapp-messenger/id310633997.Limit: at most 2048 characters.
    countrystringThe storefront, as a two-letter country code (default us). Price, rating and availability are per storefront. With url, the address's own storefront is used and country may only repeat it.Limit: matches ^[A-Za-z]{2}$.
    • Give exactly one of app_id and url. Both, or neither, is refused with invalid_input.

    Record fields

    Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.

    Record fields of app_store.app
    FieldTypeNotes
    app_idstringApple's numeric app id: the digits after "id" in the app's address.
    bundle_idstring or nullThe app's bundle identifier, e.g. net.whatsapp.WhatsApp.
    urlstringAlways present.
    titlestringAlways present.
    subtitlestring or nullnull when not known.
    descriptionstring or nullnull when not known.
    developerobject
    name (in developer)string or nullnull when not known.
    id (in developer)string or nullApple's numeric developer id.
    url (in developer)string or nullThe developer's page on the App Store.
    website (in developer)string or nullThe website the developer published on the listing (a business contact, as published).
    support_url (in developer)string or nullThe support address the developer published on the listing.
    categorystring or nullThe schema.org application category the page declares, e.g. GameApplication.
    genresarray of stringThe App Store genres the page declares, as shown for the storefront.
    ratingnumber or nullAverage rating, 0 to 5, in this storefront.
    rating_countinteger or nullNumber of ratings in this storefront.
    priceobject or nullnull when not known.
    amount (in price)numberThe amount as the store states it; 0 for a free app.
    currency (in price)string or nullThe currency code the store gives with the amount (it follows the country asked for).
    freeboolean or nullnull when not known.
    in_app_purchasesboolean or nullnull when not known.
    content_ratingstring or nullApple's age rating, e.g. "9+".
    versionstring or nullnull when not known.
    updated_atstring (date-time) or nullWhen the current version was released.
    whats_newstring or nullnull when not known.
    iconstring or nullnull when not known.
    screenshotsarray of stringThe iPhone screenshots (another device's when the app has none for iPhone).
    privacy_policy_urlstring or nullnull when not known.
    requirementsstring or nullThe operating system requirement as stated.
    devicesarray of stringThe devices the page says the app is available on.
    countrystringThe storefront, as a two-letter country code.
    languagestring or nullThe language the page was served in.
    fetched_atstring (date-time)Always present.

    Example request

    Shell
    curl -X POST "https://api.enrichednow.com/v1/scrapers/app_store.app/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"app_id":"310633997","country":"us"}}'

    The body on its own:

    JSON
    {
      "input": {
        "app_id": "310633997",
        "country": "us"
      }
    }

    Example response

    The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.

    JSON
    {
      "id": "run_6cce2b12aaf37a10b5e1b885",
      "scraper_id": "app_store.app",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "app_id": "310633997",
        "country": "us"
      },
      "record_count": 1,
      "units": 1,
      "diagnostics": {
        "requests": 1,
        "bytes": 232779,
        "wall_ms": 565,
        "facts": {}
      },
      "created_at": "2026-11-16T20:27:29.009834Z",
      "started_at": "2026-11-16T20:27:29.013803Z",
      "finished_at": "2026-11-16T20:27:29.582787Z"
    }

    Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):

    JSON
    {
      "records": [
        {
          "app_id": "string",
          "bundle_id": null,
          "url": "string",
          "title": "string",
          "subtitle": null,
          "description": null,
          "developer": {},
          "category": null,
          "genres": [],
          "rating": null,
          "rating_count": null,
          "price": null,
          "free": null,
          "in_app_purchases": null,
          "content_rating": null,
          "version": null,
          "updated_at": null,
          "whats_new": null,
          "icon": null,
          "screenshots": [],
          "privacy_policy_url": null,
          "requirements": null,
          "devices": [],
          "country": "string",
          "language": null,
          "fetched_at": "2026-01-01T00:00:00Z"
        }
      ],
      "next_cursor": null
    }

    A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.