{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts Scraper", "description": "Find Apple Podcasts shows by keyword, category chart, or show URL and ID. Records include titles, publishers, genres, ratings, descriptions, owner contact details, websites, and latest episodes. Enriches directory data with ratings from show pages and episode details from public RSS feeds.", "version": "0.1", "x-build-id": "pjcO38fBhyJo1wwrC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~apple-podcasts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-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/axiomworks~apple-podcasts-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-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/axiomworks~apple-podcasts-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-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": "Keywords to search Apple Podcasts shows by, e.g. 'marketing' or 'true crime'. Each term is searched in the country storefront and returns shows in Apple's order; Apple returns at most about 100 shows per term, so add terms or countries for more. A term with no matches returns 0 shows and a warning. Optional if genreIds or podcastUrls is given.", "items": { "type": "string" } }, "genreIds": { "title": "Category charts (genre ids)", "type": "array", "description": "Apple podcast genre ids whose top chart to collect in the country storefront, e.g. '1488' True Crime, '1321' Business, '1489' News, '1318' Technology, '1303' Comedy; '26' is the overall top podcasts chart. Shows keep their chart position in chartRank (up to 200 per chart). Optional if searchTerms or podcastUrls is given.", "items": { "type": "string", "enum": [ "26", "1301", "1482", "1402", "1459", "1306", "1405", "1406", "1321", "1410", "1493", "1412", "1491", "1492", "1494", "1303", "1496", "1495", "1497", "1304", "1501", "1499", "1498", "1500", "1483", "1486", "1484", "1485", "1511", "1512", "1513", "1514", "1518", "1517", "1515", "1516", "1487", "1305", "1519", "1521", "1522", "1520", "1502", "1510", "1503", "1504", "1506", "1507", "1505", "1508", "1509", "1310", "1523", "1524", "1525", "1489", "1490", "1526", "1531", "1530", "1527", "1529", "1528", "1314", "1438", "1439", "1463", "1440", "1441", "1532", "1444", "1533", "1538", "1539", "1540", "1541", "1536", "1534", "1537", "1542", "1535", "1324", "1543", "1302", "1443", "1320", "1544", "1545", "1549", "1548", "1554", "1560", "1547", "1553", "1550", "1552", "1551", "1546", "1558", "1556", "1557", "1559", "1555", "1309", "1562", "1564", "1565", "1563", "1561", "1318", "1488" ], "enumTitles": [ "All podcasts (overall chart) (26)", "Arts (1301)", "Arts > Books (1482)", "Arts > Design (1402)", "Arts > Fashion & Beauty (1459)", "Arts > Food (1306)", "Arts > Performing Arts (1405)", "Arts > Visual Arts (1406)", "Business (1321)", "Business > Careers (1410)", "Business > Entrepreneurship (1493)", "Business > Investing (1412)", "Business > Management (1491)", "Business > Marketing (1492)", "Business > Non-Profit (1494)", "Comedy (1303)", "Comedy > Comedy Interviews (1496)", "Comedy > Improv (1495)", "Comedy > Stand-Up (1497)", "Education (1304)", "Education > Courses (1501)", "Education > How To (1499)", "Education > Language Learning (1498)", "Education > Self-Improvement (1500)", "Fiction (1483)", "Fiction > Comedy Fiction (1486)", "Fiction > Drama (1484)", "Fiction > Science Fiction (1485)", "Government (1511)", "Health & Fitness (1512)", "Health & Fitness > Alternative Health (1513)", "Health & Fitness > Fitness (1514)", "Health & Fitness > Medicine (1518)", "Health & Fitness > Mental Health (1517)", "Health & Fitness > Nutrition (1515)", "Health & Fitness > Sexuality (1516)", "History (1487)", "Kids & Family (1305)", "Kids & Family > Education for Kids (1519)", "Kids & Family > Parenting (1521)", "Kids & Family > Pets & Animals (1522)", "Kids & Family > Stories for Kids (1520)", "Leisure (1502)", "Leisure > Animation & Manga (1510)", "Leisure > Automotive (1503)", "Leisure > Aviation (1504)", "Leisure > Crafts (1506)", "Leisure > Games (1507)", "Leisure > Hobbies (1505)", "Leisure > Home & Garden (1508)", "Leisure > Video Games (1509)", "Music (1310)", "Music > Music Commentary (1523)", "Music > Music History (1524)", "Music > Music Interviews (1525)", "News (1489)", "News > Business News (1490)", "News > Daily News (1526)", "News > Entertainment News (1531)", "News > News Commentary (1530)", "News > Politics (1527)", "News > Sports News (1529)", "News > Tech News (1528)", "Religion & Spirituality (1314)", "Religion & Spirituality > Buddhism (1438)", "Religion & Spirituality > Christianity (1439)", "Religion & Spirituality > Hinduism (1463)", "Religion & Spirituality > Islam (1440)", "Religion & Spirituality > Judaism (1441)", "Religion & Spirituality > Religion (1532)", "Religion & Spirituality > Spirituality (1444)", "Science (1533)", "Science > Astronomy (1538)", "Science > Chemistry (1539)", "Science > Earth Sciences (1540)", "Science > Life Sciences (1541)", "Science > Mathematics (1536)", "Science > Natural Sciences (1534)", "Science > Nature (1537)", "Science > Physics (1542)", "Science > Social Sciences (1535)", "Society & Culture (1324)", "Society & Culture > Documentary (1543)", "Society & Culture > Personal Journals (1302)", "Society & Culture > Philosophy (1443)", "Society & Culture > Places & Travel (1320)", "Society & Culture > Relationships (1544)", "Sports (1545)", "Sports > Baseball (1549)", "Sports > Basketball (1548)", "Sports > Cricket (1554)", "Sports > Fantasy Sports (1560)", "Sports > Football (1547)", "Sports > Golf (1553)", "Sports > Hockey (1550)", "Sports > Rugby (1552)", "Sports > Running (1551)", "Sports > Soccer (1546)", "Sports > Swimming (1558)", "Sports > Tennis (1556)", "Sports > Volleyball (1557)", "Sports > Wilderness (1559)", "Sports > Wrestling (1555)", "TV & Film (1309)", "TV & Film > After Shows (1562)", "TV & Film > Film History (1564)", "TV & Film > Film Interviews (1565)", "TV & Film > Film Reviews (1563)", "TV & Film > TV Reviews (1561)", "Technology (1318)", "True Crime (1488)" ] } }, "podcastUrls": { "title": "Podcast URLs or ids", "type": "array", "description": "Apple Podcasts show URLs such as 'https://podcasts.apple.com/us/podcast/the-daily/id1200361736' or bare numeric show ids such as '1322200189' (iTunes search or lookup API URLs work too). The country in a URL overrides the country field for that show. An id that doesn't exist is skipped with a warning. Optional if searchTerms or genreIds is given.", "items": { "type": "string" } }, "country": { "title": "Country storefront", "type": "string", "description": "Two-letter ISO 3166-1 storefront code for search and charts, e.g. 'us', 'gb', 'de', 'fr'. Default 'us'. Search results, charts and ratings differ by storefront.", "default": "us" }, "countries": { "title": "More countries", "type": "array", "description": "Optional extra two-letter storefront codes, e.g. ['gb','de']. Every search term and genre chart also runs in each of these plus 'country', so you get shows from several storefronts (Apple returns at most ~100 shows per term and country). maxItems is shared across all of them; the same show is returned once.", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Maximum shows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of shows to return across all search terms, charts and URLs together, 1-10000, default 50. The run stops as soon as this many shows are saved, and you are charged only for shows returned.", "default": 50 }, "includeRatings": { "title": "Include ratings and description", "type": "boolean", "description": "Default true: open each show's Apple Podcasts page to add ratingAverage, ratingCount and description. Set false for a faster run with only the iTunes API fields.", "default": true }, "includeFeed": { "title": "Include RSS feed data", "type": "boolean", "description": "Default true: read each show's public RSS feed to add ownerName, ownerEmail, websiteUrl, language, feedEpisodeCount and latestEpisodes. A feed that is down or too slow leaves those fields empty; the show is still returned.", "default": true }, "latestEpisodesLimit": { "title": "Latest episodes per show", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many of the newest feed episodes to keep in latestEpisodes (title, publishedAt, durationSeconds, audioUrl), 0-20, default 3. Needs includeFeed true.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for Apple requests (itunes.apple.com, podcasts.apple.com), default none. Turn on Apify Proxy only if runs get rate-limited (HTTP 403/429); retries then use a new proxy IP. RSS feeds are always fetched directly.", "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 } } } } } } } } } }