{ "openapi": "3.0.1", "info": { "title": "App Store Apps: Search, Details and Top Charts", "description": "Search the Apple App Store by keyword, look up apps by id or bundle id, or pull the top free, paid and grossing charts by country and genre. Returns ratings, rating counts, price, version, release dates, size, genres and developer for every app, through Apple's public APIs.", "version": "1.0", "x-build-id": "BQwvS8Dqw2k4vSY1n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pistachio_implementation~app-store-apps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pistachio_implementation-app-store-apps", "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/pistachio_implementation~app-store-apps/runs": { "post": { "operationId": "runs-sync-pistachio_implementation-app-store-apps", "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/pistachio_implementation~app-store-apps/run-sync": { "post": { "operationId": "run-sync-pistachio_implementation-app-store-apps", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search the App Store for, one per line, for example \"habit tracker\" or \"budget app\". Results keep Apple's order, so the position column is the search rank.", "items": { "type": "string" } }, "appIds": { "title": "App ids, App Store URLs or bundle ids", "type": "array", "description": "Apps to look up directly. Accepts numeric ids (389801252), App Store links (https://apps.apple.com/us/app/instagram/id389801252) or bundle ids (com.burbn.instagram).", "items": { "type": "string" } }, "charts": { "title": "Top charts", "type": "array", "description": "Apple top charts to read, up to 100 apps each, with rank.", "items": { "type": "string", "enum": [ "top-free-iphone", "top-paid-iphone", "top-grossing-iphone", "top-free-ipad", "top-paid-ipad", "top-grossing-ipad", "top-free-mac", "top-paid-mac", "top-grossing-mac" ], "enumTitles": [ "Top free iPhone", "Top paid iPhone", "Top grossing iPhone", "Top free iPad", "Top paid iPad", "Top grossing iPad", "Top free Mac", "Top paid Mac", "Top grossing Mac" ] } }, "chartGenreId": { "title": "Chart genre id", "type": "string", "description": "Optional App Store genre id to narrow the charts, for example 6000 Business, 6014 Games, 6015 Finance, 6013 Health and Fitness, 6017 Education, 6007 Productivity, 6016 Entertainment, 6005 Social Networking. Empty means all apps." }, "country": { "title": "Country", "type": "string", "description": "Two letter App Store country code, for example us, gb, de, fr, jp, br.", "default": "us" }, "maxResultsPerSearch": { "title": "Results per search term", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many apps to keep for each search term (Apple returns at most 200).", "default": 50 }, "maxResultsPerChart": { "title": "Apps per chart", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranked apps to keep for each chart (Apple publishes at most 100).", "default": 100 }, "includeDescription": { "title": "Include description and release notes", "type": "boolean", "description": "Turn off for smaller rows when you only need numbers.", "default": true }, "maxItems": { "title": "Maximum app rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after saving this many rows in total.", "default": 1000 } } }, "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 } } } } } } } } } }