{ "openapi": "3.0.1", "info": { "title": "Podcast Directory Scraper — Host Contacts & Emails", "description": "Search Apple Podcasts and Spotify by keyword. Extract host emails, owner contacts, website URLs, publishing frequency, and episode data. Active status filtering and multi-keyword deduplication included.", "version": "1.2", "x-build-id": "Ua56hgB53KOKbfATr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ryanclinton~podcast-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ryanclinton-podcast-directory-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/ryanclinton~podcast-directory-scraper/runs": { "post": { "operationId": "runs-sync-ryanclinton-podcast-directory-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/ryanclinton~podcast-directory-scraper/run-sync": { "post": { "operationId": "run-sync-ryanclinton-podcast-directory-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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "maxItems": 50, "type": "array", "description": "Keywords to search for on Apple Podcasts (e.g., \"true crime\", \"business marketing\", \"AI technology\").", "items": { "type": "string" }, "default": [ "technology startups" ] }, "maxResults": { "title": "Max podcasts per search term", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of podcasts to return per search term. Apple limits to 200 per query.", "default": 50 }, "country": { "title": "iTunes Store country", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "Two-letter country code for the iTunes Store to search (e.g., \"us\", \"gb\", \"de\").", "default": "us" }, "includeEpisodes": { "title": "Include episode listings", "type": "boolean", "description": "Include recent episodes for each podcast in the output. Disable to reduce output size and speed up runs.", "default": true }, "maxEpisodesPerShow": { "title": "Max episodes per podcast", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of recent episodes to include per podcast. Set to 0 for all episodes (can be very large).", "default": 10 }, "activeOnly": { "title": "Active podcasts only", "type": "boolean", "description": "Only include podcasts that have published an episode in the last 90 days.", "default": false }, "spotifyClientId": { "title": "Spotify Client ID", "type": "string", "description": "Optional. Your Spotify app Client ID for searching Spotify Podcasts. Get one free at https://developer.spotify.com/dashboard. If not provided, only Apple Podcasts will be searched." }, "spotifyClientSecret": { "title": "Spotify Client Secret", "type": "string", "description": "Optional. Your Spotify app Client Secret. Required together with Client ID to enable Spotify search." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apple's iTunes search caches 404 responses per-IP for up to 24 hours. Using Apify Proxy rotates IPs so repeat searches recover instead of hitting cached 404s. Default uses shared datacenter IPs (included free on paid Apify plans). For heavier use, select a datacenter or residential group in the proxy selector.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }