{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts Scraper – Search, Shows, Episodes & Reviews", "description": "Search Apple Podcasts and extract show metadata, episode lists (with RSS fallback) and ratings-only reviews. Filter by search term, podcast ID or feed URL. Clean JSON for podcast marketers, guest-booking agencies, researchers and AI agents.", "version": "0.1", "x-build-id": "U71TOQtwzBEIW4Gam" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rowfeed~apple-podcasts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rowfeed-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/rowfeed~apple-podcasts-scraper/runs": { "post": { "operationId": "runs-sync-rowfeed-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/rowfeed~apple-podcasts-scraper/run-sync": { "post": { "operationId": "run-sync-rowfeed-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Podcast search terms, e.g. \"artificial intelligence\" or \"true crime\". Each term is looked up against Apple's podcast search. Leave empty and use Podcast IDs or Feed URLs instead if you already know what you want.", "default": [ "artificial intelligence" ], "items": { "type": "string" } }, "podcastIds": { "title": "Podcast IDs", "type": "array", "description": "Apple Podcasts numeric collection IDs to scrape directly, e.g. 1200361736. Found in a show's apple.com URL after \"id\".", "default": [], "items": { "type": "string" } }, "feedUrls": { "title": "Feed URLs", "type": "array", "description": "RSS feed URLs to scrape directly, for shows without an Apple Podcasts catalog entry. Always processed regardless of Max podcasts.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Apple Podcasts storefront country code (ISO 3166-1 alpha-2), e.g. us, gb, de.", "default": "us" }, "maxPodcasts": { "title": "Max podcasts", "minimum": 1, "type": "integer", "description": "Keep at most this many podcasts from search terms and podcast IDs combined. Each podcast row is one `podcast` event.", "default": 50 }, "maxEpisodesPerPodcast": { "title": "Max episodes per podcast", "minimum": 0, "type": "integer", "description": "Fetch at most this many episodes per podcast (most recent first). Each episode row is one `episode` event. 0 disables episode fetching even if Include episodes is on.", "default": 20 }, "includeEpisodes": { "title": "Include episodes", "type": "boolean", "description": "Fetch episode lists for each podcast. Falls back to the show's own RSS feed when Apple's lookup returns fewer episodes than requested.", "default": true }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Fetch customer reviews for each podcast (rating, title and text only, no reviewer names). Requires an Apple podcast ID, so it has no effect on feed-only podcasts.", "default": false }, "maxReviewsPerPodcast": { "title": "Max reviews per podcast", "minimum": 0, "type": "integer", "description": "Fetch at most this many reviews per podcast when Include reviews is on. Each review row is one `review` event.", "default": 50 } } }, "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 } } } } } } } } } }