{
  "openapi": "3.0.1",
  "info": {
    "title": "App Store and Google Play Reviews Scraper | $0.12/1K",
    "description": "Pull public App Store and Google Play reviews and listings into one dataset. Schedule it to collect only new reviews, filter by stars or keywords, and pay $0.12 per 1,000 reviews. Not affiliated with Apple or Google.",
    "version": "0.2",
    "x-build-id": "ukQnyj9YnjCc2cJiC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/storelens~app-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-storelens-app-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/storelens~app-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-storelens-app-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/storelens~app-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-storelens-app-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",
        "required": [
          "apps"
        ],
        "properties": {
          "apps": {
            "title": "App Store or Google Play links",
            "minItems": 1,
            "type": "array",
            "description": "Paste an App Store link, a Google Play link, an Apple app id, or a Play package name such as com.whatsapp. Add at least one.",
            "items": {
              "type": "string"
            }
          },
          "stores": {
            "title": "Which stores",
            "type": "array",
            "description": "Leave empty and each link is read from its store. A Play package that starts with com. is Google Play only. Type apple, google, or both if you want to limit the run.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes, such as us or gb. The form starts with us. Clear the field if you want each store link to keep the country in its URL.",
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Used for Google Play. Each language is a separate set of reviews. Apple reviews follow the country, not this list. The form starts with en.",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort reviews",
            "enum": [
              "newest",
              "helpful"
            ],
            "type": "string",
            "description": "Newest first, or most helpful first.",
            "default": "newest"
          },
          "ratings": {
            "title": "Star ratings to keep",
            "type": "array",
            "description": "Optional. Keep only these stars, from 1 to 5. Enter 1 and 2 for recent 1-star and 2-star reviews. The form saves each star as text. An API call can send the number 1 or the text \"1\". Leave empty to use Minimum stars and Maximum stars instead.",
            "items": {
              "type": "string"
            }
          },
          "minRating": {
            "title": "Minimum stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Optional. Drop reviews below this star rating. Ignored when Star ratings to keep is set."
          },
          "maxRating": {
            "title": "Maximum stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Optional. Drop reviews above this star rating. Ignored when Star ratings to keep is set."
          },
          "keywords": {
            "title": "Words to keep",
            "type": "array",
            "description": "Optional. Keep a review when its title or text contains any of these words. Capital letters do not matter. Example: billing.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Words to drop",
            "type": "array",
            "description": "Optional. Drop a review when its title or text contains any of these words. Capital letters do not matter.",
            "items": {
              "type": "string"
            }
          },
          "maxReviews": {
            "title": "Maximum reviews",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "How many reviews to save for each app, store, and country. Play also splits this by language. Use 0 to save the app listing only, with no review charge. Apple stops at 500 written reviews per country.",
            "default": 100
          },
          "afterDate": {
            "title": "Only reviews after",
            "type": "string",
            "description": "Optional. Keep reviews published on or after this date, such as 2026-11-01. With newest sort, the run stops once older reviews start."
          },
          "newReviewsOnly": {
            "title": "Only new reviews",
            "type": "boolean",
            "description": "Turn this on for a scheduled run. Reviews already saved for that app, store, country, and Play language are skipped and are not charged again.",
            "default": false
          },
          "includeMetadata": {
            "title": "Save the app listing",
            "type": "boolean",
            "description": "Save the public app name, rating, price, and description. Leave this on if maximum reviews is 0.",
            "default": true
          },
          "skipUnchangedMetadata": {
            "title": "Skip an unchanged listing",
            "type": "boolean",
            "description": "Off by default, so the listing is saved every run. Turn on together with only-new-reviews to skip a listing that matches the previous run. Reviews are not affected.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "For Google Play only. Leave proxy off. If Play blocks the run, turn on Apify proxy and choose a datacenter group. Residential proxy costs much more.",
            "default": {
              "useApifyProxy": false
            }
          },
          "alertWebhookUrl": {
            "title": "Alert webhook",
            "type": "string",
            "description": "Optional. A Slack incoming webhook (hooks.slack.com) or a Discord webhook (discord.com/api/webhooks or discordapp.com). Any other address gets a JSON POST. The URL is stored as a secret and is not written to the log."
          },
          "alertMaxStars": {
            "title": "Alert at or below this many stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Optional. Alert when a saved review has this many stars or fewer. Example: 2. If words are also set, a review matches either rule."
          },
          "alertKeywords": {
            "title": "Alert words",
            "type": "array",
            "description": "Optional. Alert when the title or text contains any of these words. Capital letters do not matter. If a star limit is also set, a review matches either rule.",
            "items": {
              "type": "string"
            }
          },
          "alertMaxPerRun": {
            "title": "Maximum alerts per run",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many matching reviews to put in the alert. The default is 20 and the maximum is 50. Further matches stay in the dataset and are counted in the message.",
            "default": 20
          },
          "debugRequestLog": {
            "title": "Log request counts",
            "type": "boolean",
            "description": "Write how many requests were made and their status codes. Review text and author names are not written to the log.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}