{ "openapi": "3.0.1", "info": { "title": "Podcast Leads Scraper: Host Emails, Ratings & Activity", "description": "Find podcasts for guest pitching and sponsorship outreach. Search Apple Podcasts by keyword, genre chart or URL and get host emails from public RSS feeds and websites, socials, Apple rating, publishing activity and guest and sponsor signals. No login or API key.", "version": "0.1", "x-build-id": "hANTLgxdsKYCSIOod" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/varnmill~podcast-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-varnmill-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/varnmill~podcast-leads-scraper/runs": { "post": { "operationId": "runs-sync-varnmill-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/varnmill~podcast-leads-scraper/run-sync": { "post": { "operationId": "run-sync-varnmill-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search Apple Podcasts for, such as 'b2b marketing' or 'true crime'. Apple returns up to 100 shows per term and country; turn on 'Expand each search term' to reach several hundred.", "items": { "type": "string" } }, "expandSearch": { "title": "Expand each search term", "type": "boolean", "description": "Also search 10 variations of each term (' podcast', ' interviews', ' show' and so on) to find up to about 600 extra shows per term. Each variation is one extra Apple request, about 3 seconds each.", "default": false }, "chartGenres": { "title": "Top chart genres", "type": "array", "description": "Apple Podcasts top-chart genres to pull, by name or ID: 'All', 'Business', 'Marketing', 'Entrepreneurship', 'Technology', 'Health & Fitness', 'True Crime', 'Comedy' and every other Apple genre and subgenre. Shows keep their chart rank.", "items": { "type": "string" } }, "chartLimit": { "title": "Shows per chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many shows to take from each genre chart (Apple publishes the top 200).", "default": 100 }, "podcastUrls": { "title": "Podcast URLs, Apple IDs or RSS feeds", "type": "array", "description": "Specific shows to enrich: Apple Podcasts links (https://podcasts.apple.com/us/podcast/.../id863897795), bare Apple IDs, or RSS feed URLs.", "items": { "type": "string" } }, "countries": { "title": "Countries (Apple storefronts)", "type": "array", "description": "Two-letter Apple storefront codes for search, charts and ratings, e.g. us, gb, ca, au, de. Each country is searched separately. Default: us.", "items": { "type": "string" } }, "maxPodcasts": { "title": "Maximum podcasts", "minimum": 1, "type": "integer", "description": "Stop after this many podcasts pass your filters and are saved. You are charged only for saved podcasts.", "default": 100 }, "activeWithinDays": { "title": "Active in the last N days", "minimum": 0, "type": "integer", "description": "Keep only shows whose latest episode came out within this many days. 0 keeps everything, including shows that stopped publishing.", "default": 0 }, "minEpisodes": { "title": "Minimum episodes", "minimum": 0, "type": "integer", "description": "Skip shows with fewer episodes than this.", "default": 0 }, "languages": { "title": "Languages", "type": "array", "description": "Keep only shows whose RSS language matches, e.g. en, es, de, pt-br. 'en' matches en-us and en-gb. Empty keeps every language.", "items": { "type": "string" } }, "requireEmail": { "title": "Only shows with a contact email", "type": "boolean", "description": "Skip shows where no usable email was found. Hosting-platform relay addresses (for example ...@anchor.fm) do not count.", "default": false }, "minAppleRatingCount": { "title": "Minimum Apple ratings", "minimum": 0, "type": "integer", "description": "Skip shows with fewer Apple ratings than this in the chosen storefront. A rough size filter. Needs 'Include Apple rating'.", "default": 0 }, "includeAppleRating": { "title": "Include Apple rating", "type": "boolean", "description": "Read the star rating, rating count and star histogram from each show's public Apple Podcasts page.", "default": true }, "scanWebsite": { "title": "Scan show website", "type": "boolean", "description": "Visit the show's website (and its contact page if the home page has no email) for extra emails, social profiles and 'be a guest' or 'sponsor us' pages. Hosting-platform pages are skipped.", "default": true }, "maxConcurrency": { "title": "Parallel shows", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many shows to process at once.", "default": 8 }, "proxyConfiguration": { "title": "Proxy for Apple requests", "type": "object", "description": "Optional. Apple's public endpoints normally work without a proxy. Use one only if Apple starts rate-limiting your runs. Feeds and websites are always fetched directly.", "default": { "useApifyProxy": 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 } } } } } } } } } }