Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · App stores

    google_play.app

    One app's Google Play listing: developer, category, rating, installs, price, description, last update and images.

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

    Start it with POST /v1/scrapers/google_play.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 google_play.app
    FieldTypeDescription
    app_idrequiredstringThe app's package name, e.g. com.whatsapp.Limit: at most 150 characters, matches ^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z0-9_]+)+$.
    countrystringTwo-letter country code: the store's gl parameter. Prices and availability follow it.Limit: matches ^[A-Za-z]{2}$. Default: "us".
    languagestringLanguage code: the store's hl parameter, e.g. en, de, pt-BR.Limit: matches ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,4})?$. Default: "en".

    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 google_play.app
    FieldTypeNotes
    app_idstringThe package name, e.g. com.whatsapp.
    urlstringAlways present.
    titlestringAlways present.
    summarystring or nullThe one-line description.
    descriptionstring or nullThe full description, as text.
    developerobject
    name (in developer)string or nullnull when not known.
    id (in developer)string or nullGoogle Play's numeric developer id.
    url (in developer)string or nullThe developer's page on Google Play.
    website (in developer)string or nullThe website the developer published on the listing.
    email (in developer)string or nullThe support e-mail address the developer published on the listing: a business contact, returned exactly as published. For an app published by an individual it may be that person's own address.
    categorystring or nullThe category as shown, in the language asked for.
    category_idstring or nullGoogle Play's category code, e.g. COMMUNICATION, GAME_ARCADE.
    ratingnumber or nullAverage rating, 0 to 5.
    rating_countinteger or nullNumber of ratings.
    review_countinteger or nullNumber of written reviews.
    installsstring or nullInstalls as shown, e.g. "100,000,000+" (a bracket, formatted for the language asked for).
    min_installsinteger or nullThe same bracket as a number, e.g. 100000000.
    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 nullWhether the listing shows in-app purchases.
    in_app_price_rangestring or nullThe price range of in-app purchases as shown, e.g. "$0.99 - $49.99 per item".
    contains_adsboolean or nullWhether the listing says "Contains ads".
    content_ratingstring or nullThe age rating as shown, e.g. "Everyone 10+", "USK ab 12 Jahren".
    released_atstring (date-time) or nullnull when not known.
    updated_atstring (date-time) or nullWhen the app was last updated.
    versionstring or nullThe current version; null when the listing says it varies with the device.
    whats_newstring or nullnull when not known.
    iconstring or nullnull when not known.
    header_imagestring or nullnull when not known.
    screenshotsarray of string
    privacy_policy_urlstring or nullnull when not known.
    countrystringThe country asked for (the gl URL parameter).
    languagestringThe language asked for (the hl URL parameter).
    fetched_atstring (date-time)Always present.

    Example request

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

    The body on its own:

    JSON
    {
      "input": {
        "app_id": "com.whatsapp"
      }
    }

    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": "google_play.app",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "app_id": "com.whatsapp"
      },
      "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",
          "url": "string",
          "title": "string",
          "summary": null,
          "description": null,
          "developer": {},
          "category": null,
          "category_id": null,
          "rating": null,
          "rating_count": null,
          "review_count": null,
          "installs": null,
          "min_installs": null,
          "price": null,
          "free": null,
          "in_app_purchases": null,
          "in_app_price_range": null,
          "contains_ads": null,
          "content_rating": null,
          "released_at": null,
          "updated_at": null,
          "version": null,
          "whats_new": null,
          "icon": null,
          "header_image": null,
          "screenshots": [],
          "privacy_policy_url": null,
          "country": "string",
          "language": "string",
          "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.