{ "openapi": "3.0.1", "info": { "title": "Podcast Leads (Host Emails from Apple Podcasts)", "description": "Find podcasts by keyword or Apple Podcasts top chart and get the host contact email from each show feed. Each row has owner name, website, category, language, episode count, posting frequency, latest episode date and recent episodes. Built for guest booking, PR and sponsorship sales.", "version": "1.0", "x-build-id": "OlnAhTUDaeCmY2rf3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamole~podcast-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamole-podcast-leads-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/datamole~podcast-leads-scraper/runs": { "post": { "operationId": "runs-sync-datamole-podcast-leads-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/datamole~podcast-leads-scraper/run-sync": { "post": { "operationId": "run-sync-datamole-podcast-leads-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Topics or show names to search on Apple Podcasts. Each keyword returns up to about 100 shows per country.", "items": { "type": "string" } }, "topChartCategories": { "title": "Top chart categories", "type": "array", "description": "Add the top 200 shows of these Apple Podcasts categories in each selected country.", "items": { "type": "string", "enum": [ "1321", "1493", "1412", "1492", "1491", "1410", "1494", "1318", "1512", "1304", "1533", "1324", "1489", "1511", "1487", "1301", "1303", "1309", "1310", "1545", "1502", "1305", "1314", "1483", "1488" ], "enumTitles": [ "Business", "Business: Entrepreneurship", "Business: Investing", "Business: Marketing", "Business: Management", "Business: Careers", "Business: Non-Profit", "Technology", "Health & Fitness", "Education", "Science", "Society & Culture", "News", "Government", "History", "Arts", "Comedy", "TV & Film", "Music", "Sports", "Leisure", "Kids & Family", "Religion & Spirituality", "Fiction", "True Crime" ] } }, "countries": { "title": "Apple Podcasts countries", "type": "array", "description": "Apple Podcasts storefronts to search. More countries find more shows.", "items": { "type": "string", "enum": [ "us", "gb", "ca", "au", "ie", "nz", "in", "za", "sg", "de", "fr", "es", "it", "nl", "se", "mx", "br", "ar", "co", "cl", "pe", "jp" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "Ireland", "New Zealand", "India", "South Africa", "Singapore", "Germany", "France", "Spain", "Italy", "Netherlands", "Sweden", "Mexico", "Brazil", "Argentina", "Colombia", "Chile", "Peru", "Japan" ] }, "default": [ "us" ] }, "maxItems": { "title": "Max podcasts", "minimum": 1, "type": "integer", "description": "Hard cap for the whole run. Leave empty for no cap." }, "onlyWithEmail": { "title": "Only podcasts with a public email", "type": "boolean", "description": "Skip shows whose feed does not publish a contact email. Skipped shows are not charged.", "default": true }, "activeWithinDays": { "title": "Active within the last N days", "minimum": 0, "type": "integer", "description": "Keep only shows that published an episode in the last N days. Set 0 to keep inactive shows too.", "default": 90 }, "minEpisodes": { "title": "Minimum episodes", "minimum": 0, "type": "integer", "description": "Keep only shows with at least this many episodes in their feed.", "default": 0 }, "language": { "title": "Feed language", "type": "string", "description": "Keep only shows whose feed language starts with this code, for example en, es or pt-br. Leave empty for any language." }, "latestEpisodes": { "title": "Latest episodes per show", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many recent episodes (title, date, length and link) to include for each show.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in most cases." } } }, "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 } } } } } } } } } }