{ "openapi": "3.0.1", "info": { "title": "Podchaser Podcast Scraper — Contacts, Ratings & Audience Data", "description": "Podchaser scraper & API: search podcasts and episodes and export show title, description, category, rating, episode count, host, network, social links and RSS feed. Podcast discovery, media research and creator lead generation — fast, no login.", "version": "0.0", "x-build-id": "G3vnjeFVJ7syEfiv5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~podchaser-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-podchaser-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/haketa~podchaser-scraper/runs": { "post": { "operationId": "runs-sync-haketa-podchaser-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/haketa~podchaser-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-podchaser-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": { "categorySlugs": { "title": "Podcast Categories", "type": "array", "description": "Pick one or more categories to discover podcasts from. Each category returns a fresh page of ~25 top shows and paginates automatically. Leave empty to get a diverse, ready-to-use mix across popular categories.", "items": { "type": "string", "enum": [ "news", "news-politics", "government", "business", "technology", "comedy", "society-culture", "education", "health-fitness", "sports", "arts", "science", "history", "music", "religion", "religion-spirituality", "tv-film", "fiction", "kids-family" ], "enumTitles": [ "News", "News & Politics", "Government", "Business", "Technology", "Comedy", "Society & Culture", "Education", "Health & Fitness", "Sports", "Arts", "Science", "History", "Music", "Religion", "Religion & Spirituality", "TV & Film", "Fiction", "Kids & Family" ] }, "default": [] }, "searchNames": { "title": "Podcast Names (optional search box)", "type": "array", "description": "Optional. Type podcast names to look up specific shows (e.g. \"The Daily\", \"Serial\"). Leave empty to discover by category instead.", "default": [], "items": { "type": "string" } }, "scrapeFullProfile": { "title": "Scrape Full Profile", "type": "boolean", "description": "Visit each podcast page to extract the full record: social links with follower counts, sponsors, hosts & guests with roles, networks, audience-reach verification and similar podcasts. Turn OFF for ultra-fast listing-only discovery (title, ratings, episodes, RSS, categories from the category page alone).", "default": true }, "enrichContactFromRss": { "title": "Enrich Contact Email From RSS", "type": "boolean", "description": "Fetch each podcast's public RSS feed and extract the owner contact email (itunes:owner) plus any emails in the feed — the real address for outreach, guest pitching, PR and sponsorship. Adds one lightweight request per podcast (only the feed header is downloaded).", "default": true }, "crawlSimilar": { "title": "Crawl Similar Podcasts", "type": "boolean", "description": "Expand discovery by following the 'similar podcasts' of every scraped show. Great for building a large, tightly-themed list from a few seeds. Respects Max Records.", "default": false }, "similarDepth": { "title": "Similar Crawl Depth", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many hops to follow when 'Crawl Similar Podcasts' is on. 1 = only the similar shows of your seeds.", "default": 1 }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop podcasts below this average rating (0–5). 0 = no filter.", "default": 0 }, "minReviews": { "title": "Minimum Reviews", "minimum": 0, "type": "integer", "description": "Drop podcasts with fewer reviews than this. 0 = no filter.", "default": 0 }, "minEpisodes": { "title": "Minimum Episodes", "minimum": 0, "type": "integer", "description": "Drop podcasts with fewer published episodes than this. Useful to skip inactive or trailer-only shows. 0 = no filter.", "default": 0 }, "requireContactEmail": { "title": "Only Podcasts With a Contact Email", "type": "boolean", "description": "Keep only podcasts where a contact email was found (requires 'Enrich Contact Email From RSS'). Turns the output into a clean, ready-to-use outreach list.", "default": false }, "maxRecords": { "title": "Max Records", "minimum": 0, "type": "integer", "description": "Total cap on podcasts to return. 0 = unlimited. Leave at 100 for a fast, representative run.", "default": 0 }, "maxPagesPerCategory": { "title": "Max Pages Per Category", "minimum": 1, "type": "integer", "description": "Pagination depth per category (~25 podcasts per page).", "default": 4 }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Advanced / optional. Paste any Podchaser URL — a podcast page, a category page, or an episodes page — to scrape it directly. Most users can ignore this and simply pick categories above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "podcastIds": { "title": "Podcast IDs or Slugs (advanced)", "type": "array", "description": "Advanced / optional. Scrape specific podcasts directly by Podchaser ID (e.g. 90473) or slug-id (e.g. the-daily-90473). Most users can ignore this and pick categories above.", "default": [], "items": { "type": "string" } }, "requestDelay": { "title": "Request Delay (ms)", "minimum": 0, "type": "integer", "description": "Delay between requests. Higher = gentler on Podchaser.", "default": 700 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "Parallel request count. 3–5 is a good balance of speed and politeness.", "default": 4 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Default: NO proxy — Podchaser serves data over plain HTTPS and does not require a proxy. Enable Apify Proxy (Datacenter is plenty, Residential for very large runs) only if you hit per-IP rate limits on big jobs." } } }, "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 } } }, "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 } } } } } } } } } }