{ "openapi": "3.0.1", "info": { "title": "App Store Developer Leads - iOS Developers, Emails & Sites", "description": "Find iOS app developers by keyword, genre or top charts: apps, ratings, update activity, website, emails and social links published on their own site, plus a lead score. One row per developer. Pay only per developer.", "version": "0.0", "x-build-id": "a2Ri2fX7Mb9Nz4IMf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tiger19935~app-store-developer-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tiger19935-app-store-developer-leads", "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/tiger19935~app-store-developer-leads/runs": { "post": { "operationId": "runs-sync-tiger19935-app-store-developer-leads", "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/tiger19935~app-store-developer-leads/run-sync": { "post": { "operationId": "run-sync-tiger19935-app-store-developer-leads", "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", "top-charts" ], "type": "string", "description": "'search' looks up apps for your search terms / genres through the iTunes Search API. 'top-charts' reads Apple's top 100 chart for each country and then looks up those apps.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords used as App Store searches, one per row, e.g. fitness, meditation, invoice, crypto wallet. Each term is searched in each country and returns up to 200 apps. Required in 'search' mode unless you pick genres. Ignored in 'top-charts' mode.", "default": [], "items": { "type": "string" } }, "genres": { "title": "Genres (optional filter)", "type": "array", "description": "Keep only apps in these App Store genres: names such as Health & Fitness, Productivity, Games, Finance, Education or numeric ids such as 6013. If you give genres but no search terms, the genre names are used as search terms.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Countries (App Store storefronts)", "type": "array", "description": "Two-letter storefront codes, e.g. us, gb, de, fr, ua, br, jp. Every term is searched in every country, which multiplies the number of requests (Apple allows roughly 20 searches per minute, so big combinations take minutes).", "default": [ "us" ], "items": { "type": "string" } }, "chartType": { "title": "Chart (top-charts mode)", "enum": [ "top-free", "top-paid" ], "type": "string", "description": "Which Apple chart to read in 'top-charts' mode.", "default": "top-free" }, "maxDevelopers": { "title": "Max developers", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of developers to deliver (and pay for), 1-1000. When more developers match, the highest lead scores are kept. The run also stops softly when your maximum cost per run is reached.", "default": 50 }, "minRatingCount": { "title": "Min total ratings", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Keep only developers whose apps together have at least this many ratings in the storefront(s) searched. A quick proxy for traction. 0 = no minimum.", "default": 0 }, "appsUpdatedWithinDays": { "title": "Apps updated within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Ignore apps whose current version was released more than N days ago (finds actively maintained products). Developers with no remaining app are dropped, and appCount only counts the remaining apps. 0 = no recency filter.", "default": 0 }, "findEmails": { "title": "Find emails and social links", "type": "boolean", "description": "Visit each developer's own website (the seller URL listed in the App Store): the homepage plus up to 2 contact/support/about pages, obeying robots.txt. Extracts published emails (MX-checked) and LinkedIn/X/Facebook/Instagram/YouTube/GitHub/TikTok links. No emails are guessed. Slower, but no extra charge.", "default": true }, "includeFailed": { "title": "Add free rows for failed queries", "type": "boolean", "description": "Push one extra row (type 'error', never charged) for every Apple request that failed. The run summary in the OUTPUT record always lists the status of every query.", "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 } } } } } } } } } }