{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Play Reviews Scraper: Reviews, Ratings & App Data",
    "description": "Scrape Google Play reviews with developer replies, ratings and full app details for any Android app. Many languages in one run, star/date/keyword/version filters, a monitoring mode that only returns new reviews, a free per-app insights summary, plus search and top charts. $0.10 per 1,000 reviews.",
    "version": "1.0",
    "x-build-id": "VbN1yn9CA7vvnniKt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blueberry_rainstorm~google-play-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blueberry_rainstorm-google-play-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/blueberry_rainstorm~google-play-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blueberry_rainstorm-google-play-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/blueberry_rainstorm~google-play-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blueberry_rainstorm-google-play-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "apps": {
            "title": "Apps",
            "type": "array",
            "description": "One app per line. Paste a Google Play link (https://play.google.com/store/apps/details?id=com.duolingo), a package name (com.duolingo) or just the app name (Duolingo). Names are matched to the top Google Play search result.",
            "default": [
              "https://play.google.com/store/apps/details?id=com.duolingo"
            ],
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Review languages",
            "type": "array",
            "description": "Google Play groups reviews by language, so each language gives a different set of reviews. Two-letter codes, e.g. en, de, fr, es, pt, ja. Add several to collect reviews in all of them in one run (no duplicates).",
            "default": [
              "en"
            ],
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes, e.g. us, gb, de, in. App details (price, rating, in-app purchase range), search and top charts are read in each country. Reviews use the first country.",
            "default": [
              "us"
            ],
            "items": {
              "type": "string"
            }
          },
          "includeReviews": {
            "title": "Get reviews",
            "type": "boolean",
            "description": "Collect user reviews: star rating, full text, app version, date, thumbs-up count and the developer's reply.",
            "default": true
          },
          "maxReviewsPerApp": {
            "title": "Max reviews per app per language",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Google Play pages through all reviews, so large apps can give tens of thousands. About 150 reviews take half a second.",
            "default": 100
          },
          "reviewSort": {
            "title": "Sort order",
            "enum": [
              "newest",
              "mostRelevant",
              "rating"
            ],
            "type": "string",
            "description": "Newest is best for monitoring and is used automatically with monitoring or a start date.",
            "default": "newest"
          },
          "minRating": {
            "title": "Minimum stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Only keep reviews with at least this many stars. Set Minimum 1 and Maximum 2 to get only negative reviews. Star filters run on Google's side where possible, so they are fast.",
            "default": 1
          },
          "maxRating": {
            "title": "Maximum stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Only keep reviews with at most this many stars.",
            "default": 5
          },
          "reviewsSince": {
            "title": "Only reviews since",
            "type": "string",
            "description": "Only keep reviews written on or after this date (YYYY-MM-DD). The scraper stops as soon as it reaches older reviews, so it is also faster."
          },
          "keywords": {
            "title": "Only reviews mentioning",
            "type": "array",
            "description": "Keep a review if its text contains any of these words or phrases (not case sensitive), e.g. crash, login, subscription, refund.",
            "items": {
              "type": "string"
            }
          },
          "appVersion": {
            "title": "Only this app version",
            "type": "string",
            "description": "Optional. Keep only reviews written on app versions that start with this, e.g. 6.12 or 6.12.3."
          },
          "onlyNewReviews": {
            "title": "Monitoring: only new reviews since my last run",
            "type": "boolean",
            "description": "Remembers the newest review it saw for each app and language, and on the next run returns only reviews written since then, so you never pay twice for the same review. Schedule it daily or hourly. The first run returns up to 'Max reviews' as a baseline.",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional. Name for this monitor's memory, e.g. my-app-daily. Use a different name for each schedule that watches the same apps. Default: built from the apps and languages."
          },
          "includeSummary": {
            "title": "Add a free summary per app",
            "type": "boolean",
            "description": "Adds one free row per app with the star split of the collected reviews, average rating per app version and per language, how often and how fast the developer replies, the most common complaint and praise phrases, and the 5 worst recent reviews.",
            "default": true
          },
          "includeAppDetails": {
            "title": "Get app details",
            "type": "boolean",
            "description": "One row per app per country: rating, rating count and the full 1 to 5 star histogram, installs, price, in-app purchase range, ads, version, last update, release notes, content rating, Data safety section, similar apps, screenshots and more.",
            "default": true
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Optional. Keywords to search on Google Play, e.g. habit tracker. Returns the ranked list of apps, useful for App Store Optimization (ASO) and competitor research.",
            "items": {
              "type": "string"
            }
          },
          "maxSearchResults": {
            "title": "Max results per search term",
            "minimum": 1,
            "maximum": 250,
            "type": "integer",
            "description": "How many apps to return for each search term and country.",
            "default": 30
          },
          "charts": {
            "title": "Top charts",
            "type": "array",
            "description": "Optional. Google Play top charts to read, per country.",
            "items": {
              "type": "string",
              "enum": [
                "topFree",
                "topPaid",
                "topGrossing"
              ],
              "enumTitles": [
                "Top free",
                "Top paid",
                "Top grossing"
              ]
            }
          },
          "chartCategory": {
            "title": "Chart category",
            "enum": [
              "APPLICATION",
              "ANDROID_WEAR",
              "ART_AND_DESIGN",
              "AUTO_AND_VEHICLES",
              "BEAUTY",
              "BOOKS_AND_REFERENCE",
              "BUSINESS",
              "COMICS",
              "COMMUNICATION",
              "DATING",
              "EDUCATION",
              "ENTERTAINMENT",
              "EVENTS",
              "FINANCE",
              "FOOD_AND_DRINK",
              "HEALTH_AND_FITNESS",
              "HOUSE_AND_HOME",
              "LIBRARIES_AND_DEMO",
              "LIFESTYLE",
              "MAPS_AND_NAVIGATION",
              "MEDICAL",
              "MUSIC_AND_AUDIO",
              "NEWS_AND_MAGAZINES",
              "PARENTING",
              "PERSONALIZATION",
              "PHOTOGRAPHY",
              "PRODUCTIVITY",
              "SHOPPING",
              "SOCIAL",
              "SPORTS",
              "TOOLS",
              "TRAVEL_AND_LOCAL",
              "VIDEO_PLAYERS",
              "WATCH_FACE",
              "WEATHER",
              "GAME",
              "GAME_ACTION",
              "GAME_ADVENTURE",
              "GAME_ARCADE",
              "GAME_BOARD",
              "GAME_CARD",
              "GAME_CASINO",
              "GAME_CASUAL",
              "GAME_EDUCATIONAL",
              "GAME_MUSIC",
              "GAME_PUZZLE",
              "GAME_RACING",
              "GAME_ROLE_PLAYING",
              "GAME_SIMULATION",
              "GAME_SPORTS",
              "GAME_STRATEGY",
              "GAME_TRIVIA",
              "GAME_WORD",
              "FAMILY"
            ],
            "type": "string",
            "description": "Limit charts to one category, e.g. Games: Puzzle or Finance.",
            "default": "APPLICATION"
          },
          "chartLimit": {
            "title": "Apps per chart",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Up to 200 apps per chart.",
            "default": 100
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}