{
  "openapi": "3.0.1",
  "info": {
    "title": "App Store Reviews Scraper: iOS Reviews, Ratings & App Data",
    "description": "Scrape Apple App Store reviews, ratings and app details for any app in 180 countries. Up to 1,000 unique reviews per country, star/date/keyword filters, a monitoring mode that only returns new reviews, free per-app insights summary, plus search and top charts. $0.15 per 1,000 reviews.",
    "version": "1.0",
    "x-build-id": "tilWQcUeKlP1mB5ho"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blueberry_rainstorm~app-store-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blueberry_rainstorm-app-store-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~app-store-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blueberry_rainstorm-app-store-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~app-store-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blueberry_rainstorm-app-store-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 an App Store link (https://apps.apple.com/us/app/.../id570060128), a numeric app ID (570060128), a bundle ID (com.duolingo.DuolingoMobile) or just the app name (Duolingo). Names are matched to the top App Store search result.",
            "default": [
              "https://apps.apple.com/us/app/duolingo-language-lessons/id570060128"
            ],
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries (App Store storefronts)",
            "type": "array",
            "description": "Two-letter country codes, e.g. us, gb, de, fr, jp. Each app is read in each country, because reviews, ratings and prices differ per storefront. Use ALL for every storefront (about 180).",
            "default": [
              "us"
            ],
            "items": {
              "type": "string"
            }
          },
          "includeReviews": {
            "title": "Get reviews",
            "type": "boolean",
            "description": "Collect user reviews: star rating, title, text, app version, date and helpful votes.",
            "default": true
          },
          "maxReviewsPerApp": {
            "title": "Max reviews per app per country",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Apple's public review feed returns up to 500 reviews per sort order per country. Choose 'Both' sort orders below to reach up to 1,000 unique reviews per country.",
            "default": 100
          },
          "reviewSort": {
            "title": "Sort order",
            "enum": [
              "mostRecent",
              "mostHelpful",
              "both"
            ],
            "type": "string",
            "description": "Most recent is best for monitoring. Most helpful surfaces the reviews other users voted up. Both merges the two lists without duplicates.",
            "default": "mostRecent"
          },
          "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.",
            "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 paging 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 title or text contains any of these words or phrases (not case sensitive), e.g. crash, login, subscription, refund.",
            "items": {
              "type": "string"
            }
          },
          "onlyNewReviews": {
            "title": "Monitoring: only new reviews since my last run",
            "type": "boolean",
            "description": "Remembers the newest review it saw for each app and country, 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 countries."
          },
          "includeSummary": {
            "title": "Add a free summary per app",
            "type": "boolean",
            "description": "Adds one free row per app with the star distribution of the collected reviews, average rating per app version and per country, 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: name, developer, price, rating and rating count, full 1 to 5 star histogram, version, release notes, size, languages, privacy labels, in-app purchases, similar apps, screenshots and more.",
            "default": true
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Optional. Keywords to search in the App Store, 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": 200,
            "type": "integer",
            "description": "How many apps to return for each search term and country (Apple returns up to 200).",
            "default": 25
          },
          "charts": {
            "title": "Top charts",
            "type": "array",
            "description": "Optional. Apple's top charts to read, per country.",
            "items": {
              "type": "string",
              "enum": [
                "topFree",
                "topPaid",
                "topGrossing",
                "topFreeIpad",
                "topPaidIpad",
                "topGrossingIpad",
                "newApps",
                "newFree",
                "newPaid",
                "topFreeMac",
                "topPaidMac",
                "topGrossingMac"
              ],
              "enumTitles": [
                "Top free (iPhone)",
                "Top paid (iPhone)",
                "Top grossing (iPhone)",
                "Top free (iPad)",
                "Top paid (iPad)",
                "Top grossing (iPad)",
                "New apps",
                "New free apps",
                "New paid apps",
                "Top free (Mac)",
                "Top paid (Mac)",
                "Top grossing (Mac)"
              ]
            }
          },
          "chartGenre": {
            "title": "Chart category",
            "enum": [
              "",
              "6000",
              "6001",
              "6002",
              "6003",
              "6004",
              "6005",
              "6006",
              "6007",
              "6008",
              "6009",
              "6010",
              "6011",
              "6012",
              "6013",
              "6014",
              "6015",
              "6016",
              "6017",
              "6018",
              "6020",
              "6021",
              "6022",
              "6023",
              "6024",
              "6025",
              "6026",
              "6027"
            ],
            "type": "string",
            "description": "Limit charts to one category.",
            "default": ""
          },
          "chartLimit": {
            "title": "Apps per chart",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Apple returns at most 100 to 110 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}