{
  "openapi": "3.0.1",
  "info": {
    "title": "App Store Scraper - Search, Details, Reviews, Charts & Ranks",
    "description": "All-in-one Apple App Store scraper: keyword search with search API rank, full app details, customer reviews filtered by stars, keyword and date, top charts by country and genre, and every app by a publisher. Type an app name, URL or ID. Official Apple APIs, no login.",
    "version": "1.0",
    "x-build-id": "z766hTGHb89FrFvF0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/appdata-labs~app-store-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-appdata-labs-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/appdata-labs~app-store-scraper/runs": {
      "post": {
        "operationId": "runs-sync-appdata-labs-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/appdata-labs~app-store-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-appdata-labs-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",
              "developer"
            ],
            "type": "string",
            "description": "What to fetch. search: apps for keywords, with searchRank. details: full listings for the apps you name. reviews: customer reviews for those apps, with optional star, keyword and date filters. charts: a top chart for one country and genre. developer: every app by the publisher of each app or developer you name.",
            "default": "search"
          },
          "searchKeywords": {
            "title": "Search keywords (search mode)",
            "type": "array",
            "description": "One search per keyword, read in search mode only. Each row carries searchQuery and searchRank: the position in the results of Apple's iTunes Search API, which usually tracks but can differ from the order the App Store app shows on an iPhone.",
            "default": [
              "habit tracker",
              "budget app"
            ],
            "items": {
              "type": "string"
            }
          },
          "apps": {
            "title": "Apps or developers (details, reviews, developer modes)",
            "type": "array",
            "description": "Each entry can be an app name as the store shows it (Duolingo), an App Store URL (https://apps.apple.com/us/app/notion/id1232780281), a numeric app ID (1232780281) or a bundle ID (com.burbn.instagram). In developer mode it can also be a publisher name (Spotify) or Apple's numeric developer ID (284882218). Each entry is resolved on its own: one that cannot be found is skipped with a reason, and the run fails only if none resolve.",
            "default": [
              "https://apps.apple.com/us/app/notion/id1232780281",
              "310633997",
              "363590051"
            ],
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter code of the App Store storefront to read, for example us, gb, de, jp or th. Search results, charts, prices and reviews are all per country.",
            "default": "us"
          },
          "maxResultsPerInput": {
            "title": "Max results per input",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Search: results per keyword. Reviews: reviews per app. Charts: chart length. Developer: apps per publisher. Details returns one row per app and ignores it. Capped at Apple's own limits: 200, or 500 for reviews. Every row is charged, so keep it small for fast, cheap runs.",
            "default": 10
          },
          "chart": {
            "title": "Chart (charts mode)",
            "enum": [
              "topFreeApps",
              "topPaidApps",
              "topGrossingApps",
              "newApps",
              "newFreeApps",
              "newPaidApps"
            ],
            "type": "string",
            "description": "Which Apple chart to read in charts mode. Each row carries its rank, plus rating and rating count added from a lookup.",
            "default": "topFreeApps"
          },
          "chartCategoryId": {
            "title": "Chart category ID (charts mode)",
            "type": "string",
            "description": "Four-digit Apple genre ID to narrow the chart, for example 6014 (Games), 6007 (Productivity), 6015 (Finance) or 6013 (Health & Fitness). Leave empty for the overall chart.",
            "default": ""
          },
          "reviewSort": {
            "title": "Review order (reviews mode)",
            "enum": [
              "mostRecent",
              "mostHelpful"
            ],
            "type": "string",
            "description": "mostRecent returns the newest reviews first, for monitoring. mostHelpful returns the reviews Apple ranks highest, for research. If the order asked for is silent for an app, the other is used and each row says which in feedSort.",
            "default": "mostRecent"
          },
          "minRating": {
            "title": "Minimum stars (reviews mode)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Keep only reviews with at least this many stars, 1 to 5. Leave at 1 for no lower bound. Filtering happens before charging: you pay only for reviews that match.",
            "default": 1
          },
          "maxRating": {
            "title": "Maximum stars (reviews mode)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Keep only reviews with at most this many stars, 1 to 5. Leave at 5 for no upper bound. Set 2 for complaints and bug reports.",
            "default": 5
          },
          "reviewKeywords": {
            "title": "Only reviews mentioning (reviews mode)",
            "type": "array",
            "description": "Keep only reviews whose title or text contains at least one of these words or phrases, case-insensitive. Leave empty for no keyword filter. Example: crash, subscription, refund.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "reviewsSince": {
            "title": "Only reviews since (reviews mode)",
            "type": "string",
            "description": "Keep only reviews written or updated on or after this date, in YYYY-MM-DD form, for example 2026-09-01. Leave empty for no date filter.",
            "default": ""
          },
          "includeFullText": {
            "title": "Include the full description",
            "type": "boolean",
            "description": "Off by default. App descriptions run to thousands of characters and a dozen screenshot URLs, which makes rows too big for an AI agent. Turn on for the complete text and every screenshot in search, details and developer modes.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}