{ "openapi": "3.0.1", "info": { "title": "Podcast Search & New Episode Monitor (Apple Podcasts + RSS)", "description": "Search Apple Podcasts, pull top charts by genre, read each show's RSS feed for publishing stats and episodes, and get only new episodes on every scheduled run. No API key.", "version": "0.1", "x-build-id": "rMWEqMUigEgo4y2jD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yiafirm~podcast-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yiafirm-podcast-monitor", "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/yiafirm~podcast-monitor/runs": { "post": { "operationId": "runs-sync-yiafirm-podcast-monitor", "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/yiafirm~podcast-monitor/run-sync": { "post": { "operationId": "run-sync-yiafirm-podcast-monitor", "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": "Find shows on Apple Podcasts by keyword, for example \"venture capital\" or \"homeschool\".", "items": { "type": "string" } }, "maxShowsPerSearch": { "title": "Shows per search term", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many shows to keep for each search term (Apple returns up to 200).", "default": 25 }, "podcasts": { "title": "Specific podcasts", "type": "array", "description": "Apple Podcasts links (https://podcasts.apple.com/us/podcast/name/id123456789), Apple IDs, or RSS feed URLs.", "items": { "type": "string" } }, "includeTopChart": { "title": "Include Apple top chart", "type": "boolean", "description": "Add the current Apple Podcasts top chart, with each show's rank.", "default": false }, "chartGenreId": { "title": "Chart genre ID", "type": "string", "description": "Optional Apple genre ID, for example 1321 (Business), 1318 (Technology), 1489 (News), 1304 (Education), 1303 (Comedy). Leave empty for the overall chart." }, "chartLimit": { "title": "Chart size", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many chart positions to read.", "default": 50 }, "country": { "title": "Store country", "type": "string", "description": "Two-letter Apple storefront country for search and charts, for example US, GB, CA, DE.", "default": "US" }, "includeEpisodes": { "title": "Include episodes", "type": "boolean", "description": "Add episode rows from each show's RSS feed.", "default": true }, "maxEpisodesPerShow": { "title": "Episodes per show", "minimum": 0, "type": "integer", "description": "Newest episodes to keep per show. Use a high number for a full archive.", "default": 20 }, "episodesPublishedAfter": { "title": "Episodes published after", "type": "string", "description": "Only episodes on or after this date (YYYY-MM-DD)." }, "enrichFromFeed": { "title": "Add feed stats to shows", "type": "boolean", "description": "Read each show's RSS feed for website, language, first and latest episode date, publishing frequency and active status. Always on when episodes are included.", "default": true }, "maxResults": { "title": "Maximum rows per run", "minimum": 1, "type": "integer", "description": "Stop after saving this many rows (shows plus episodes).", "default": 2000 }, "onlyNewEpisodes": { "title": "Only new shows and episodes since last run (monitor mode)", "type": "boolean", "description": "Remember what was already returned and output only new shows and episodes on later runs. Pair with a schedule for new-episode alerts. The first run returns everything that matches.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Use a different name for each separate watch list so their memories don't mix.", "default": "default" } } }, "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 } } } } } } } } } }