{ "openapi": "3.0.1", "info": { "title": "Spotify Podcast Episode Extractor", "description": "Export every episode of any Spotify podcast with title, full description, duration, release date and share link - plus chapter timestamps, sponsor domains and likely guest names mined out of the descriptions. Includes show rating and review count. No Spotify account or API key needed.", "version": "0.0", "x-build-id": "2F1R5bipKO371Lah6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~spotify-podcast-episode-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-spotify-podcast-episode-extractor", "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/fanndev~spotify-podcast-episode-extractor/runs": { "post": { "operationId": "runs-sync-fanndev-spotify-podcast-episode-extractor", "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/fanndev~spotify-podcast-episode-extractor/run-sync": { "post": { "operationId": "run-sync-fanndev-spotify-podcast-episode-extractor", "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": { "showUrls": { "title": "Podcast URLs", "type": "array", "description": "Spotify shows to read. Share links, /intl-xx/ localised links, spotify:show: URIs and bare show ids all work.", "items": { "type": "string" } }, "showNames": { "title": "Podcast names", "type": "array", "description": "Podcasts to look up by name instead of by link, one per line. Each name costs one extra search request and the run log prints which show it matched, so check the log when a name is ambiguous.", "items": { "type": "string" } }, "episodeUrls": { "title": "Individual episode URLs", "type": "array", "description": "Specific episodes to read, for when you already know which ones you want. One request each.", "items": { "type": "string" } }, "startUrls": { "title": "Mixed URLs", "type": "array", "description": "Show and episode links mixed together, for callers that keep one list.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxEpisodesPerShow": { "title": "Maximum episodes per show", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many episodes per show. Spotify serves 100 episodes per request, so a 500-episode back catalogue costs five.", "default": 100 }, "releasedAfter": { "title": "Released on or after", "type": "string", "description": "YYYY-MM-DD. Episodes arrive newest first, so this also stops paging as soon as the catalogue goes older than the date - reading recent episodes of a long-running show costs a couple of requests rather than hundreds." }, "releasedBefore": { "title": "Released on or before", "type": "string", "description": "YYYY-MM-DD. Combine with releasedAfter to pull one month, quarter or season." }, "mineDescriptions": { "title": "Mine the descriptions", "type": "boolean", "description": "Parse each description for chapter timestamps, links, sponsor domains and @handles, and derive likely guest names from the episode title. Costs no extra requests - it reads text that is already in the response. Guest names are labelled guestHints because nothing on Spotify marks who the guest is.", "default": true }, "includeShowRecord": { "title": "Include a show summary row", "type": "boolean", "description": "Emit one SHOW record per podcast with publisher, description, episode count, average rating, review count and cover art, alongside the EPISODE records.", "default": true }, "exportFormats": { "title": "Extra export files", "type": "array", "description": "Besides the dataset, write ready-made files into this run's key-value store.", "items": { "type": "string", "enum": [ "json", "ndjson", "csv", "excel" ], "enumTitles": [ "JSON", "NDJSON", "CSV", "Excel (XLSX)" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default and genuinely optional: the endpoint this actor reads has no WAF and no IP block. Turn it on only for very large back-catalogue sweeps.", "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 } } } } } } } } } }