{ "openapi": "3.0.1", "info": { "title": "Podcast Prospect Finder", "description": "Find podcasts to pitch for guest spots and sponsorship. Search any topic, get the host contact email, the last episode date and the show size, then filter down to shows that are still publishing.", "version": "0.1", "x-build-id": "GS6D3PxKj9mZBRnmT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~podcast-prospect-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-podcast-prospect-finder", "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/arched_friend~podcast-prospect-finder/runs": { "post": { "operationId": "runs-sync-arched_friend-podcast-prospect-finder", "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/arched_friend~podcast-prospect-finder/run-sync": { "post": { "operationId": "run-sync-arched_friend-podcast-prospect-finder", "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": [ "topics" ], "properties": { "topics": { "title": "Topics to search", "type": "array", "description": "Topics your ideal show covers, one per line, for example b2b marketing or bootstrapped saas. Each topic is searched separately and the results are merged.", "items": { "type": "string" } }, "country": { "title": "Country store", "type": "string", "description": "Two letter country code for the Apple Podcasts store to search, for example us or gb.", "default": "us" }, "maxPerTopic": { "title": "Shows per topic", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many shows to pull for each topic before filtering. Apple returns at most 200.", "default": 50 }, "lookUpContactDetails": { "title": "Look up contact email and activity", "type": "boolean", "description": "Read each show's feed to recover the host contact email, website and last episode date. Turn this off for a faster run that returns listing data only.", "default": true }, "requireEmail": { "title": "Only shows with a contact email", "type": "boolean", "description": "Drop shows whose feed publishes no contact address. Needs the contact lookup turned on.", "default": false }, "activeOnly": { "title": "Only shows still publishing", "type": "boolean", "description": "Drop shows that have not released an episode recently, so you do not pitch a dead podcast. Needs the contact lookup turned on.", "default": false }, "activeWithinDays": { "title": "Counts as active within", "minimum": 1, "type": "integer", "description": "How recently a show must have published to count as active.", "default": 90 }, "minEpisodes": { "title": "Minimum episodes", "minimum": 0, "type": "integer", "description": "Drop shows with fewer episodes than this. A useful way to skip abandoned launches.", "default": 0 }, "genre": { "title": "Genre contains", "type": "string", "description": "Keep only shows whose genre contains this word, for example business or health." }, "excludeTerms": { "title": "Exclude shows mentioning", "type": "array", "description": "Drop any show whose name, publisher or description contains one of these words, one per line.", "items": { "type": "string" } }, "onlyNewShows": { "title": "Only shows I have not seen", "type": "boolean", "description": "Remember every show returned across runs and report only the ones that appeared since last time. Turn this on for scheduled prospecting.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Recommended when reading many feeds in one run.", "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 } } } } } } } } } }