{ "openapi": "3.0.1", "info": { "title": "Apple Podcast Charts Scraper", "description": "Top podcast charts from Apple Podcasts for any country, up to 100 shows each, with rank, publisher, RSS feed, episode count and the date of the newest episode. Narrow a chart to genres such as True Crime or Business, add ratings or episodes, or schedule it to catch new entrants.", "version": "0.1", "x-build-id": "QXin075czT97cczwP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~podcast-charts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-podcast-charts-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/deriverge~podcast-charts-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-podcast-charts-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/deriverge~podcast-charts-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-podcast-charts-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": [ "chartCountries" ], "properties": { "chartCountries": { "title": "Chart countries", "type": "array", "description": "Two-letter storefront codes whose top charts to read, for example us, gb, de, au, jp. One chart per country and genre.", "items": { "type": "string" } }, "chartGenres": { "title": "Chart genres", "type": "array", "description": "Genre names or Apple genre IDs, for example Business, True Crime, Technology, Daily News or 1489. Subgenres work too, for example Entrepreneurship. Apple's official chart feed has no genre charts, so a genre returns the shows of that genre found in the overall top 100, in chart order. Leave empty for the overall chart.", "items": { "type": "string" } }, "chartKind": { "title": "Chart", "enum": [ "top", "top-subscriber" ], "type": "string", "description": "Both charts come from Apple's official chart feed and go to 100 entries. The subscriber chart ranks shows by paid subscriptions.", "default": "top" }, "chartLimit": { "title": "Chart size", "minimum": 1, "maximum": 200, "type": "integer", "description": "Entries per chart, from the top. Apple's official chart feed lists up to 100, so larger values return 100.", "default": 100 }, "includeRatings": { "title": "Include ratings", "type": "boolean", "description": "Read the average rating and the number of ratings from each podcast's page. One extra request per podcast, no extra charge.", "default": false }, "includeEpisodes": { "title": "Include episodes", "type": "boolean", "description": "Read each podcast's feed and return its episodes with audio URL, duration, numbers and show notes. Charged per episode.", "default": false }, "maxEpisodesPerPodcast": { "title": "Maximum episodes per podcast", "minimum": 1, "type": "integer", "description": "Newest first. Podcast feeds carry the whole archive, so this is what keeps a broad run affordable.", "default": 50 }, "episodesPublishedAfter": { "title": "Episodes published after", "type": "string", "description": "Drop episodes older than this date (YYYY-MM-DD). Episodes without a date are kept. Dropped episodes are never charged." }, "keywords": { "title": "Episode keywords (any of)", "type": "array", "description": "Keep only episodes whose title, show notes or categories contain at least one of these words or phrases as whole words, case-insensitive. Dropped episodes are never charged.", "items": { "type": "string" } }, "includeContent": { "title": "Full show notes", "type": "boolean", "description": "Return the complete show notes as plain text in the content field. Otherwise summary holds the first 300 characters and content is null.", "default": false }, "maxPodcasts": { "title": "Maximum podcasts", "minimum": 1, "type": "integer", "description": "Cap on distinct chart entries collected across all charts in the run.", "default": 500 }, "newOnly": { "title": "Return only rows new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only chart entries that were not there before. Schedule it daily and you have a chart alert that bills only for new entrants; the CHANGES record also lists rank moves and shows that dropped out.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"true-crime-us\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned rows in the run, podcasts and episodes together.", "default": 5000 } } }, "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 } } } } } } } } } }