{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts Scraper: Shows, Episodes, Reviews & Charts", "description": "Search Apple Podcasts, pull show details and full episode lists from the podcast's own RSS feed, collect listener reviews in any country, and read the Top Shows charts. No login or API key.", "version": "0.0", "x-build-id": "bmSEvQ8xZW0X12GT7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/winterlock~apple-podcasts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-winterlock-apple-podcasts-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/winterlock~apple-podcasts-scraper/runs": { "post": { "operationId": "runs-sync-winterlock-apple-podcasts-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/winterlock~apple-podcasts-scraper/run-sync": { "post": { "operationId": "run-sync-winterlock-apple-podcasts-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": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "search", "podcastDetails", "episodes", "reviews", "topCharts" ], "type": "string", "description": "Search for shows, pull details of specific shows, list their episodes, collect listener reviews, or read the Top Shows chart.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "For Search. Each term returns shows in Apple's ranking order, with a searchRank field.", "items": { "type": "string" } }, "podcasts": { "title": "Podcasts", "type": "array", "description": "For Show details, Episodes and Reviews. Paste Apple Podcasts links (https://podcasts.apple.com/us/podcast/name/id1234567890) or bare numeric IDs.", "items": { "type": "string" } }, "feedUrls": { "title": "RSS feed URLs (optional)", "type": "array", "description": "For Episodes. Use this to read a podcast's feed directly without looking it up on Apple first.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter storefront codes such as us, gb, de, au. Reviews and charts differ by country.", "items": { "type": "string" } }, "reviewSort": { "title": "Review order", "enum": [ "mostrecent", "mosthelpful", "both" ], "type": "string", "description": "Apple returns up to 500 reviews per show, per country, per order. Choose Both to collect up to 1,000 (duplicates removed).", "default": "mostrecent" }, "maxReviewsPerPodcastPerCountry": { "title": "Max reviews per show per country", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many reviews for each show in each country.", "default": 200 }, "onlyNewReviews": { "title": "Only new reviews since the last run (monitoring)", "type": "boolean", "description": "Remembers the newest review seen for each show and country, and on later runs returns only newer ones. Schedule the Actor daily to get a feed of new reviews and pay only for those.", "default": false }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at least this many stars." }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep only reviews with at most this many stars. Set to 2 to collect only complaints." }, "includeReviewerNames": { "title": "Include reviewer nicknames", "type": "boolean", "description": "Turn off to leave out reviewer nicknames and profile links.", "default": true }, "maxEpisodesPerPodcast": { "title": "Max episodes per show", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Episodes are read newest-first from the show's RSS feed.", "default": 100 }, "maxResultsPerSearch": { "title": "Max results per search term", "minimum": 1, "maximum": 200, "type": "integer", "description": "Apple's search API returns at most 200 shows per term and country.", "default": 50 }, "chartLimit": { "title": "Shows per chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many shows to read from the Top Shows chart.", "default": 50 }, "enrichChartsWithDetails": { "title": "Add RSS feed and episode count to chart entries", "type": "boolean", "description": "Looks up each charted show to add its feed URL, episode count, genre and release date. Charged as a show per entry.", "default": false }, "maxItems": { "title": "Max items in total", "minimum": 1, "type": "integer", "description": "Stop the run after saving this many items. Leave empty for no limit." }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Lower this if you see rate-limit retries in the log.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for most runs. Use Apify Proxy for very large jobs if Apple starts rate-limiting.", "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 } } } } } } } } } }