{
"openapi": "3.0.1",
"info": {
"title": "Apple App Store Scraper: Apps, Top Charts, ASO & Reviews",
"description": "Get App Store app details, top charts by country and category, keyword search rankings for ASO, developer portfolios and optional customer reviews via Apple's public iTunes Search/Lookup API and RSS feeds. No login, no proxies.",
"version": "1.0",
"x-build-id": "wqmhCaLZslP6Sl4G8"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/sysco32~apple-app-store-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-sysco32-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/sysco32~apple-app-store-scraper/runs": {
"post": {
"operationId": "runs-sync-sysco32-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/sysco32~apple-app-store-scraper/run-sync": {
"post": {
"operationId": "run-sync-sysco32-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": {
"countries": {
"title": "Countries (App Store storefronts)",
"type": "array",
"description": "Two-letter store country codes, e.g. us, gb, de, pl, jp. Every chart, search and lookup runs once per country.",
"default": [
"us"
],
"items": {
"type": "string"
}
},
"charts": {
"title": "Top charts",
"type": "array",
"description": "Apple's official RSS top charts. Each chart entry is enriched with full app metadata through the Lookup API.",
"items": {
"type": "string",
"enum": [
"top-free",
"top-paid",
"top-grossing",
"top-free-ipad",
"top-paid-ipad",
"top-grossing-ipad",
"new-apps",
"new-free",
"new-paid"
],
"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"
]
},
"default": [
"top-free"
]
},
"chartGenreIds": {
"title": "Chart categories (optional)",
"type": "array",
"description": "Limit charts to App Store categories. Leave empty for the overall chart. Each category is a separate chart request.",
"items": {
"type": "string",
"enum": [
"6000",
"6001",
"6002",
"6003",
"6004",
"6005",
"6006",
"6007",
"6008",
"6009",
"6010",
"6011",
"6012",
"6013",
"6014",
"6015",
"6016",
"6017",
"6018",
"6020",
"6021",
"6023",
"6024",
"6026",
"6027"
],
"enumTitles": [
"Business",
"Weather",
"Utilities",
"Travel",
"Sports",
"Social Networking",
"Reference",
"Productivity",
"Photo & Video",
"News",
"Navigation",
"Music",
"Lifestyle",
"Health & Fitness",
"Games",
"Finance",
"Entertainment",
"Education",
"Books",
"Medical",
"Magazines & Newspapers",
"Food & Drink",
"Shopping",
"Developer Tools",
"Graphics & Design"
]
}
},
"chartLimit": {
"title": "Apps per chart",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Number of chart positions to return (Apple serves up to 100).",
"default": 25
},
"searchTerms": {
"title": "Search keywords (ASO keyword ranks)",
"type": "array",
"description": "App Store search keywords. Each result gets its search rank, so you can track keyword positions over time.",
"default": [
"habit tracker"
],
"items": {
"type": "string"
}
},
"searchLimit": {
"title": "Results per keyword",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "How many search results to keep per keyword and country (max 200).",
"default": 10
},
"trackAppIds": {
"title": "Track these apps in keyword results",
"type": "array",
"description": "Optional app IDs or App Store URLs. When a tracked app is missing from a keyword's results, the Actor writes a keyword_rank row with rank: null, so your rank tracker sees the drop.",
"items": {
"type": "string"
}
},
"appIds": {
"title": "Apps to look up",
"type": "array",
"description": "App Store URLs (https://apps.apple.com/us/app/duolingo/id570060128), numeric app IDs (570060128) or bundle IDs (com.duolingo.DuolingoMobile).",
"default": [
"https://apps.apple.com/us/app/duolingo-language-lessons/id570060128"
],
"items": {
"type": "string"
}
},
"developerIds": {
"title": "Developers (all their apps)",
"type": "array",
"description": "Developer page URLs (https://apps.apple.com/us/developer/duolingo/id570060131) or numeric developer IDs.",
"items": {
"type": "string"
}
},
"includeDescription": {
"title": "Include description and release notes",
"type": "boolean",
"description": "Turn off for a smaller dataset.",
"default": true
},
"includeReviews": {
"title": "Include customer reviews",
"type": "boolean",
"description": "Fetch the latest customer reviews from Apple's public reviews RSS feed (up to 500 per app and country, charged per review).",
"default": false
},
"reviewsScope": {
"title": "Reviews for",
"enum": [
"lookup",
"all"
],
"type": "string",
"description": "Which apps get reviews.",
"default": "lookup"
},
"maxReviewsPerApp": {
"title": "Max reviews per app and country",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Apple's reviews feed serves at most 10 pages of 50 reviews per app and country.",
"default": 100
},
"reviewsSort": {
"title": "Review order",
"enum": [
"mostrecent",
"mosthelpful"
],
"type": "string",
"description": "Most recent is best for monitoring, most helpful for research.",
"default": "mostrecent"
},
"onlyNewReviews": {
"title": "Only new reviews (monitoring mode)",
"type": "boolean",
"description": "Remember the reviews already delivered and output only new ones. Schedule the Actor daily for review alerts.",
"default": false
},
"trackRankChanges": {
"title": "Track rank changes",
"type": "boolean",
"description": "Store the last chart and keyword ranks, and add previous_rank, rank_change (positive means moved up) and is_new_entry to every chart and search row.",
"default": true
},
"stateStoreName": {
"title": "State store name",
"type": "string",
"description": "Named key-value store for rank history and seen reviews. Use a different name for each independent tracker.",
"default": "apple-app-store-scraper-state"
},
"apiIntervalSecs": {
"title": "Seconds between Search/Lookup API calls",
"minimum": 3,
"maximum": 30,
"type": "number",
"description": "Apple allows about 20 Search/Lookup calls per minute, so the minimum is 3 s. Lookups are batched (100 apps per call).",
"default": 3.2
}
}
},
"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
}
}
}
}
}
}
}
}
}
}