{ "openapi": "3.0.1", "info": { "title": "App Intelligence · App Store & Google Play Search, Charts", "description": "App Store and Google Play in one run: search both stores, top charts by country and category, full app details (ratings, installs, price, version, developer), similar apps, and each app's iOS or Android twin with a confidence score. No login. $1.80 per 1,000 apps; first 25 apps each month free.", "version": "1.0", "x-build-id": "kAPimmLFDLE8aU7MT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agentsgearbox~app-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agentsgearbox-app-intelligence", "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/agentsgearbox~app-intelligence/runs": { "post": { "operationId": "runs-sync-agentsgearbox-app-intelligence", "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/agentsgearbox~app-intelligence/run-sync": { "post": { "operationId": "run-sync-agentsgearbox-app-intelligence", "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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Search terms to run in the selected stores (e.g. \"budget tracker\", \"meditation\"). Each query returns up to maxResultsPerQuery apps per store and country.", "items": { "type": "string" } }, "appIds": { "title": "Apps to look up", "type": "array", "description": "Google Play package names (com.whatsapp), App Store numeric ids (310633997), bundle ids (net.whatsapp.WhatsApp) or store URLs. Each gets full details, and its twin on the other store when findTwins is on.", "items": { "type": "string" } }, "charts": { "title": "Top charts", "type": "array", "description": "Charts to fetch per store and country. Google Play: top free, top paid, top grossing (optionally within a category). App Store: top free and top paid, overall.", "items": { "type": "string", "enum": [ "top-free", "top-paid", "top-grossing" ], "enumTitles": [ "Top free", "Top paid", "Top grossing (Google Play only)" ] }, "default": [] }, "chartCategories": { "title": "Chart categories", "type": "array", "description": "Optional Google Play categories for the charts (GAME, FINANCE, HEALTH_AND_FITNESS, PRODUCTIVITY, SHOPPING, …). Apple’s public chart feed has no category filter, so App Store charts are always the overall charts. Leave empty for overall charts on both stores.", "items": { "type": "string" } }, "chartSize": { "title": "Apps per chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many apps to take from each chart (max 200).", "default": 50 }, "stores": { "title": "Stores", "type": "array", "description": "Which stores to query.", "items": { "type": "string", "enum": [ "google-play", "app-store" ], "enumTitles": [ "Google Play", "Apple App Store" ] }, "default": [ "google-play", "app-store" ] }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter store countries (us, gb, de, it, br, in, jp …). Searches, charts and lookups run once per country.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language of titles and descriptions where the store supports it (Google Play).", "default": "en" }, "maxResultsPerQuery": { "title": "Results per search query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Apps returned per query, store and country.", "default": 20 }, "includeDetails": { "title": "Fetch full details for every app", "type": "boolean", "description": "Adds ratings histogram, installs, version, release and update dates, content rating, in-app purchases, developer contact and the full description to every app found by search or charts. Costs one extra request per app on Google Play; App Store details are batched.", "default": true }, "findTwins": { "title": "Find each app's twin on the other store", "type": "boolean", "description": "Searches the other store by title and developer and attaches the best match with a confidence score (0-1). Only when both stores are selected.", "default": true }, "includeSimilar": { "title": "Include similar apps (Google Play)", "type": "boolean", "description": "Adds the Google Play 'similar apps' list for apps looked up by id.", "default": false }, "includeDescription": { "title": "Include full description text", "type": "boolean", "description": "Adds the complete store description to detail rows (can be long).", "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 } } } } } } } } } }