{
  "openapi": "3.0.1",
  "info": {
    "title": "Apple App Store Scraper - iOS Apps, App Store Reviews & Charts",
    "description": "Scrape iOS App Store apps, reviews, search results and top charts from many countries and keywords in one run. 30+ app fields, 1–5 star rating histogram, review star and date filters, no charge for invalid input. No API key needed.",
    "version": "0.1",
    "x-build-id": "bA06hk7QVuiu5Z7Eb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automation-lab~apple-app-store-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automation-lab-apple-app-store-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/automation-lab~apple-app-store-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automation-lab-apple-app-store-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/automation-lab~apple-app-store-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automation-lab-apple-app-store-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": {
          "mode": {
            "title": "🔧 Mode",
            "enum": [
              "search",
              "details",
              "reviews",
              "charts"
            ],
            "type": "string",
            "description": "Choose what to scrape: search for apps, get app details, extract reviews, or discover a top chart.",
            "default": "search"
          },
          "searchTerm": {
            "title": "Search keyword",
            "type": "string",
            "description": "Keyword to search for apps (used in 'search' mode). Example: \"photo editor\", \"fitness tracker\". Ignored when 'Search keywords' is filled."
          },
          "searchTerms": {
            "title": "Search keywords (several in one run)",
            "type": "array",
            "description": "Optional list of keywords to search in one run, e.g. photo editor, image filters, collage maker. Apple returns at most 200 apps per keyword and store, so more keywords means more apps. The same app found by two keywords is delivered and charged once per store. Max results applies to the whole run. Every row gets a searchTerm field.",
            "items": {
              "type": "string"
            }
          },
          "appIds": {
            "title": "App IDs or URLs",
            "type": "array",
            "description": "Apple App Store URLs or numeric app IDs. Used in 'details' and 'reviews' modes. Example: \"https://apps.apple.com/us/app/instagram/id389801252\" or \"389801252\".",
            "items": {
              "type": "string"
            }
          },
          "chartType": {
            "title": "Chart",
            "enum": [
              "top-free",
              "top-paid"
            ],
            "type": "string",
            "description": "Apple chart to discover (used only in 'charts' mode).",
            "default": "top-free"
          },
          "chartLimit": {
            "title": "Chart results",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Number of ranked apps to resolve in 'charts' mode (1–100).",
            "default": 50
          },
          "country": {
            "title": "🌍 Country",
            "type": "string",
            "description": "Two-letter App Store country code, e.g. us, gb, de, jp. Affects prices, ratings, availability and review language. Ignored when 'Countries' is filled.",
            "default": "us"
          },
          "countries": {
            "title": "Countries (several stores in one run)",
            "type": "array",
            "description": "Optional list of two-letter App Store country codes to scrape in one run, e.g. us, gb, de, fr, jp. Every row gets a country field. Apple shows up to 500 reviews per app per country, so more countries means more reviews. Max results applies to the whole run; charts return Chart results apps per country.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum rows of each requested output type. In details mode with reviews enabled, this allows up to this many app rows plus this many review rows. Set 0 for unlimited. Keep low for first runs to control costs.",
            "default": 50
          },
          "includeReviews": {
            "title": "Include reviews with app details",
            "type": "boolean",
            "description": "When in 'details' mode, also fetch up to Max results review rows across the requested apps, in addition to up to Max results app rows. App details and reviews are charged separately.",
            "default": false
          },
          "includeRatingHistogram": {
            "title": "Include rating histogram (1–5 stars)",
            "type": "boolean",
            "description": "Adds a ratingHistogram field with the number of 1, 2, 3, 4 and 5 star ratings to every app row, for that country store. Works in search, details and charts modes at no extra charge. Slower: Apple allows about 1 app page per second, so 200 apps take around 3 minutes.",
            "default": false
          },
          "reviewSort": {
            "title": "Review sort order",
            "enum": [
              "mostRecent",
              "mostHelpful"
            ],
            "type": "string",
            "description": "How to sort reviews. Only used in 'reviews' mode or when 'Include reviews' is enabled.",
            "default": "mostRecent"
          },
          "reviewMinRating": {
            "title": "Minimum review stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Only return reviews with at least this many stars (1–5). Filtered-out reviews are not charged."
          },
          "reviewMaxRating": {
            "title": "Maximum review stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Only return reviews with at most this many stars (1–5). Example: set to 2 to collect only complaints."
          },
          "reviewsSince": {
            "title": "Reviews since date",
            "type": "string",
            "description": "Only return reviews posted on or after this date (YYYY-MM-DD). With Most recent sort the scraper stops paging once reviews get older, so daily monitoring runs are fast and only new reviews are charged."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}