{ "openapi": "3.0.1", "info": { "title": "Podcast Scraper: Apple Charts, Shows, Hosts & Episodes", "description": "Podcasts from Apple Podcasts search, top charts (any country and genre) and links, with each show's owner name and email, website, language, categories, episode count, posting frequency and last episode, plus episodes with audio and transcript links.", "version": "0.1", "x-build-id": "7CB97NBheeHc55GDQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~podcasts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-podcasts", "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/tacps126~podcasts/runs": { "post": { "operationId": "runs-sync-tacps126-podcasts", "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/tacps126~podcasts/run-sync": { "post": { "operationId": "run-sync-tacps126-podcasts", "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": "Podcasts matching these words in Apple Podcasts.", "items": { "type": "string" } }, "chartGenres": { "title": "Top charts", "type": "array", "description": "Apple's top podcasts for these genres (All = the overall chart).", "items": { "type": "string", "enum": [ "All", "Arts", "Business", "Comedy", "Education", "Fiction", "Government", "Health & Fitness", "History", "Kids & Family", "Leisure", "Music", "News", "Religion & Spirituality", "Science", "Society & Culture", "Sports", "Technology", "True Crime", "TV & Film" ] } }, "podcasts": { "title": "Podcast links", "type": "array", "description": "Apple Podcasts links or ids, or RSS feed links.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter store country for search and charts, e.g. us, gb, in, de.", "default": "us" }, "maxPerSource": { "title": "Podcasts per search or chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Charts go up to 200.", "default": 50 }, "includeEpisodes": { "title": "Include episodes", "type": "boolean", "description": "Also return the latest episodes of each podcast (title, date, duration, audio and transcript links).", "default": false }, "maxEpisodesPerPodcast": { "title": "Episodes per podcast", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Newest first.", "default": 10 }, "minEpisodes": { "title": "Min episodes", "minimum": 0, "type": "integer", "description": "Leave out podcasts with fewer episodes." }, "activeWithinDays": { "title": "Posted in the last N days", "minimum": 1, "type": "integer", "description": "Only podcasts with an episode in this window (active shows)." }, "withEmailOnly": { "title": "With contact email only", "type": "boolean", "description": "Only podcasts whose feed lists an owner email.", "default": false }, "languages": { "title": "Languages", "type": "array", "description": "Feed language codes, e.g. en, es, de.", "items": { "type": "string" } }, "excludeExplicit": { "title": "Leave out explicit", "type": "boolean", "description": "Drop podcasts marked explicit.", "default": false }, "maxItems": { "title": "Max podcasts", "minimum": 1, "type": "integer", "description": "Most podcasts returned per run.", "default": 500 }, "onlyNew": { "title": "Only new podcasts", "type": "boolean", "description": "Schedule the Actor and each run returns only podcasts earlier runs did not deliver (new shows entering a chart or search).", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the “only new” history, so several monitors can run side by side." }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "default": 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 } } } } } } } } } }