{ "openapi": "3.0.1", "info": { "title": "Apple App Store Search Scraper", "description": "Search the Apple App Store for apps matching a search term. Scrape rich app information app's name, developer, description, price, rating....", "version": "0.0", "x-build-id": "YpR8wo2KjGAsRlukR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dan.scraper~apple-app-store-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dan.scraper-apple-app-store-search-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/dan.scraper~apple-app-store-search-scraper/runs": { "post": { "operationId": "runs-sync-dan.scraper-apple-app-store-search-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/dan.scraper~apple-app-store-search-scraper/run-sync": { "post": { "operationId": "run-sync-dan.scraper-apple-app-store-search-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": [ "queries" ], "properties": { "queries": { "title": "Search Queries", "type": "array", "description": "List of search queries. The actor will search the Apple App Store for each query and extract the results.", "items": { "type": "string" } }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "type": "integer", "description": "The maximum number of search result pages crawled for each search query or URL." }, "csvFriendlyOutput": { "title": "Output CSV friendly format", "type": "boolean", "description": "Include shopping results data, use for CSV format" }, "countryCode": { "title": "Country", "enum": [ "", "al", "dz", "ao", "ai", "ag", "ar", "am", "au", "at", "az", "bs", "bh", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "bw", "br", "vg", "bn", "bg", "bf", "kh", "ca", "cv", "ky", "cl", "td", "cn", "co", "cd", "cr", "hr", "cy", "cz", "dk", "dm", "do", "ec", "eg", "sv", "ee", "fj", "fi", "fr", "de", "gm", "gb", "gh", "gr", "gd", "gt", "gw", "gy", "hn", "hk", "hu", "is", "in", "id", "ie", "il", "it", "jm", "jp", "jo", "kz", "ke", "kw", "kg", "la", "lv", "lb", "li", "lt", "lu", "mo", "mk", "mg", "mw", "my", "ml", "mt", "mr", "mu", "mx", "fm", "md", "mn", "ms", "mz", "na", "np", "nl", "nz", "ni", "ne", "ng", "no", "om", "pk", "pw", "pa", "pg", "py", "pe", "ph", "pl", "pt", "qa", "ro", "ru", "st", "sa", "sn", "sc", "sl", "sg", "sk", "si", "sb", "za", "kr", "es", "lk", "kn", "lc", "vc", "sr", "sz", "se", "ch", "tw", "tj", "tz", "th", "tt", "tn", "tr", "tm", "tc", "ug", "ua", "ae", "us", "uy", "uz", "ve", "vn", "ye", "zw" ], "type": "string", "description": "This param is for the Country (e.g. es for Spain). The values must be lower-cased ISO 3166 country codes supported by Apple App Store. By default, the actor uses United States (us)." }, "languageCode": { "title": "Language", "enum": [ "", "pt-br", "it-it", "hi-in", "ca-es", "es-es", "zh-tw", "th-th", "da-dk", "fi-fi", "en-gb", "nl-nl", "pl-pl", "ro-ro", "zh-cn", "no-no", "pt-pt", "de-ch", "uk-ua", "en-us", "vi-vi", "sv-se", "en-ca", "fr-fr", "sk-sk", "zh-hk", "hr-hr", "en-au", "ko-kr", "tr-tr", "el-gr", "ms-my", "id-id", "cs-cz", "hu-hu", "fr-ca", "es-mx", "de-de", "ru-ru", "ja-jp" ], "type": "string", "description": "Language for the search results. Only set this if you want to use a non-default language for the selected country. Example:
pt-br For Portugese - Brazil
it-it For Italian - Italy
hi-in For Hindi - India
ca-es For Catalan - Spain
es-es For Spanish - Spain
zh-tw For Chinese - Taiwan
th-th For Thai - Thailand
da-dk For Danish - Denmark
fi-fi For Finnish - Finland
en-gb For English - United Kingdom
nl-nl For Dutch - Netherlands
pl-pl For Polish - Poland
ro-ro For Romanian - Romania
zh-cn For Chinese - China
no-no For Norwegian - Norway
pt-pt For Portugese - Portugal
de-ch For German - Switzerland
uk-ua For Ukrainian - Ukraine
en-us For English - United States
vi-vi For Vietnamese - Vietnam
sv-se For Swedish - Sweden
en-ca For English - Canada
fr-fr For French - France
sk-sk For Slovakian - Slovakia
zh-hk For Chinese - Hong Kong
hr-hr For Croatian - Croatia
en-au For English - Australia
ko-kr For Korean - South Korea
tr-tr For Turkish - Turkey
el-gr For Greek - Greece
ms-my For Malay - Malaysia
id-id For Indonesian - Indonesia
cs-cz For Czech - Czechia
hu-hu For Hungarian - Hungary
fr-ca For French - Canada
es-m", "default": "" }, "searchDeveloperName": { "title": "Searching Developer Name", "type": "boolean", "description": "Search both app name and developer name. If you want to search only app name, set this to false." }, "appCategory": { "title": "App Category ID", "enum": [ "", "6018", "6000", "6026", "6017", "6016", "6015", "6023", "6014", "7001", "7002", "7003", "7004", "7005", "7006", "7009", "7011", "7012", "7013", "7014", "7015", "7016", "7017", "7018", "7019", "6027", "6013", "6012", "6021", "6020", "6011", "6010", "6009", "6008", "6007", "6006", "6005", "6024", "6004", "6003", "6002", "6001" ], "type": "string", "description": "App Category ID for the search results. Example:
6018 For Books
6000 For Business
6026 For Developer Tools
6017 For Education
6016 For Entertainment
6015 For Finance
6023 For Food & Drink
6014 For Games
7001 For Games: Action
7002 For Games: Adventure
7003 For Games: Casual
7004 For Games: Board
7005 For Games: Card
7006 For Games: Casino
7009 For Games: Family
7011 For Games: Music
7012 For Games: Puzzle
7013 For Games: Racing
7014 For Games: Role Playing
7015 For Games: Simulation
7016 For Games: Sports
7017 For Games: Strategy
7018 For Games: Trivia
7019 For Games: Word
6027 For Graphics & Design
6013 For Health & Fitness
6012 For Lifestyle
6021 For Magazines & Newspapers
6020 For Medical
6011 For Music
6010 For Navigation
6009 For News
" }, "device": { "title": "Device", "enum": [ "desktop", "mobile", "tablet" ], "type": "string", "description": "Device can be \"desktop\", \"mobile\" or \"tablet.", "default": "desktop" } } }, "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 } } }, "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 } } } } } } } } } }