{ "openapi": "3.0.1", "info": { "title": "Podcast Leads Scraper - Host Emails, Websites & Guest Shows", "description": "Find podcasts on Apple Podcasts by keyword, top chart or your own list. One row per show with the host email (from the feed or the show's website), website, socials, how active it is and whether it takes guests.", "version": "1.0", "x-build-id": "crq7KGXKeOjP8UwoH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/snappytools~podcast-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-snappytools-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/snappytools~podcast-leads-scraper/runs": { "post": { "operationId": "runs-sync-snappytools-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/snappytools~podcast-leads-scraper/run-sync": { "post": { "operationId": "run-sync-snappytools-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": { "mode": { "title": "How to find podcasts", "enum": [ "search", "charts", "list" ], "type": "string", "description": "Search Apple Podcasts by keyword, take the top charts for a category, or check a list of podcasts you already have.", "default": "search" }, "searches": { "title": "Search words", "type": "array", "description": "One search per line, as you would type it in Apple Podcasts: \"marketing\", \"real estate investing\", \"true crime\", \"parenting\". Each line runs in every country you pick. Used with \"Search by keyword\".", "default": [ "marketing" ], "items": { "type": "string" } }, "countries": { "title": "Countries (Apple Podcasts store)", "type": "array", "description": "Which Apple Podcasts store to search or take charts from. Each search line or chart runs in every country you pick. Shows from other countries still appear when they're listed in that store.", "items": { "type": "string", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "sg", "za", "ph", "my", "ng", "ae", "de", "fr", "es", "it", "nl", "se", "br", "mx", "jp" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "India", "Singapore", "South Africa", "Philippines", "Malaysia", "Nigeria", "United Arab Emirates", "Germany", "France", "Spain", "Italy", "Netherlands", "Sweden", "Brazil", "Mexico", "Japan" ] }, "default": [ "us" ] }, "categories": { "title": "Categories", "type": "array", "description": "With \"Top charts by category\": one chart per category you pick (leave empty for the overall top podcasts chart). With \"Search by keyword\": keep only podcasts in these categories.", "items": { "type": "string", "enum": [ "1301", "1482", "1402", "1459", "1306", "1405", "1406", "1321", "1410", "1493", "1412", "1491", "1492", "1494", "1303", "1496", "1495", "1497", "1304", "1501", "1499", "1498", "1500", "1483", "1511", "1512", "1513", "1514", "1518", "1517", "1515", "1516", "1487", "1305", "1521", "1502", "1510", "1503", "1506", "1507", "1505", "1508", "1509", "1310", "1489", "1490", "1526", "1531", "1530", "1527", "1529", "1528", "1314", "1439", "1444", "1533", "1324", "1543", "1302", "1443", "1320", "1544", "1545", "1549", "1548", "1554", "1560", "1318", "1488", "1309", "1562", "1564", "1565", "1563", "1561" ], "enumTitles": [ "Arts", "Arts › Books", "Arts › Design", "Arts › Fashion & Beauty", "Arts › Food", "Arts › Performing Arts", "Arts › Visual Arts", "Business", "Business › Careers", "Business › Entrepreneurship", "Business › Investing", "Business › Management", "Business › Marketing", "Business › Non-Profit", "Comedy", "Comedy › Comedy Interviews", "Comedy › Improv", "Comedy › Stand-Up", "Education", "Education › Courses", "Education › How To", "Education › Language Learning", "Education › Self-Improvement", "Fiction", "Government", "Health & Fitness", "Health & Fitness › Alternative Health", "Health & Fitness › Fitness", "Health & Fitness › Medicine", "Health & Fitness › Mental Health", "Health & Fitness › Nutrition", "Health & Fitness › Sexuality", "History", "Kids & Family", "Kids & Family › Parenting", "Leisure", "Leisure › Animation & Manga", "Leisure › Automotive", "Leisure › Crafts", "Leisure › Games", "Leisure › Hobbies", "Leisure › Home & Garden", "Leisure › Video Games", "Music", "News", "News › Business News", "News › Daily News", "News › Entertainment News", "News › News Commentary", "News › Politics", "News › Sports News", "News › Tech News", "Religion & Spirituality", "Religion & Spirituality › Christianity", "Religion & Spirituality › Spirituality", "Science", "Society & Culture", "Society & Culture › Documentary", "Society & Culture › Personal Journals", "Society & Culture › Philosophy", "Society & Culture › Places & Travel", "Society & Culture › Relationships", "Sports", "Sports › Baseball", "Sports › Basketball", "Sports › Cricket", "Sports › Fantasy Sports", "Technology", "True Crime", "TV & Film", "TV & Film › After Shows", "TV & Film › Film History", "TV & Film › Film Interviews", "TV & Film › Film Reviews", "TV & Film › TV Reviews" ] } }, "podcastUrls": { "title": "My list", "type": "array", "description": "With \"My list\": one podcast per line. Paste an Apple Podcasts link (https://podcasts.apple.com/us/podcast/.../id1234567890), an Apple ID (1234567890) or an RSS feed address. Spotify links can't be used because Spotify doesn't publish feeds.", "items": { "type": "string" } }, "maxPodcastsPerSearch": { "title": "Max podcasts per search or chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stop after this many podcasts for each search line, chart and country. Apple returns about 100 per search and up to 200 per chart. Podcasts left out by your filters don't count. Not used for \"My list\".", "default": 50 }, "findContacts": { "title": "Find emails on the show's website", "type": "boolean", "description": "When the feed has no email (common on Buzzsprout, Podbean, Captivate and RSS.com), find the show's website and check its homepage and contact or \"be a guest\" page for emails, social links and phone numbers. Turn off for a faster run with feed emails only.", "default": true }, "activeWithinDays": { "title": "Only shows with an episode in the last", "enum": [ "30", "60", "90", "180", "365", "any" ], "type": "string", "description": "Leave out shows that have gone quiet. Not used for \"My list\", where every show you list is returned and the isActive column tells you.", "default": "90" }, "minEpisodes": { "title": "Minimum episodes", "minimum": 0, "type": "integer", "description": "Leave out shows with fewer episodes than this (0 = no minimum).", "default": 0 }, "language": { "title": "Language", "type": "string", "description": "Only shows whose feed is in this language. Use the two-letter code: en, es, de, fr, pt. Leave empty for any language." }, "hideExplicit": { "title": "Leave out explicit shows", "type": "boolean", "description": "Skip shows marked explicit on Apple or in their feed.", "default": false }, "onlyWithEmail": { "title": "Only shows with an email", "type": "boolean", "description": "Return only podcasts where an email was found (in the feed or on the website). Shows without one are left out and not charged.", "default": false }, "onlyGuestFriendly": { "title": "Only shows that take guests", "type": "boolean", "description": "Keep only shows whose recent episodes look like interviews (guest names in titles, \"with ...\", \"feat.\", or guests tagged in the feed). Good for guest booking.", "default": false }, "onlyNewSinceLastRun": { "title": "Only new podcasts since my last run", "type": "boolean", "description": "Skip podcasts an earlier run with the same input already gave you, so you pay for each lead once. Use it on a schedule.", "default": false }, "watchName": { "title": "Memory name (optional)", "type": "string", "description": "With \"Only new podcasts\": give a name to share one memory between runs with different inputs, for example \"guest-outreach\". Leave empty to keep a memory per input." } } }, "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 } } } } } } } } } }