{
  "openapi": "3.0.1",
  "info": {
    "title": "Apple Podcasts Scraper: Episodes & Reviews",
    "description": "Collect public Apple Podcasts shows, episodes, charts, and listener reviews. Get source links, podcast details, and available audio URLs for research and exports.",
    "version": "0.0",
    "x-build-id": "0KskofyYFq5lHHNf5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~apple-podcast/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-apple-podcast",
        "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/maximedupre~apple-podcast/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-apple-podcast",
        "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/maximedupre~apple-podcast/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-apple-podcast",
        "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": [
          "resultType"
        ],
        "properties": {
          "resultType": {
            "title": "Result type",
            "enum": [
              "shows",
              "episodes",
              "charts",
              "genres",
              "channels",
              "creators",
              "participants",
              "reviews"
            ],
            "type": "string",
            "description": "Choose the kind of records to collect."
          },
          "showSelection": {
            "title": "Find shows by",
            "enum": [
              "search",
              "lookup",
              "related",
              "channel",
              "creator",
              "new"
            ],
            "type": "string",
            "description": "Search uses Keywords. Direct lookup uses show IDs or URLs. Related shows, Channel shows, and Creator shows use Sources for that show, channel, or creator. New shows uses the storefront.",
            "default": "search"
          },
          "episodeSelection": {
            "title": "Find episodes by",
            "enum": [
              "search",
              "lookup",
              "show",
              "feed",
              "creator"
            ],
            "type": "string",
            "description": "Search uses Keywords. Direct lookup uses episode IDs or URLs. Show history uses show IDs or URLs and includes public publisher feeds. Public feeds uses feed URLs. Creator episodes uses creator IDs or URLs.",
            "default": "show"
          },
          "releasedFrom": {
            "title": "Released on or after",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Include episodes released on or after this date."
          },
          "releasedTo": {
            "title": "Released on or before",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Include episodes released on or before this date."
          },
          "minDurationSeconds": {
            "title": "Minimum episode length in seconds",
            "minimum": 0,
            "type": "integer",
            "description": "Include episodes at least this long."
          },
          "chartType": {
            "title": "Chart",
            "enum": [
              "shows",
              "episodes",
              "channels"
            ],
            "type": "string",
            "description": "Choose show, episode, or channel rankings. Records include available ranks and storefront details.",
            "default": "shows"
          },
          "reviewOrder": {
            "title": "Review order",
            "enum": [
              "newest",
              "mostHelpful"
            ],
            "type": "string",
            "description": "Choose which reviews to collect first for the show IDs or URLs in Sources.",
            "default": "newest"
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Enter one or more search terms. Used for Shows and Episodes with Keyword search, and for Channels. Channels can use both Keywords and Sources.",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "title": "Sources",
            "type": "array",
            "description": "Enter IDs or public URLs of the same kind. Shows and Episodes use the source kind named in their selection. Channels and Creators accept their own IDs or URLs. Participants accepts show or episode IDs or URLs. Reviews accepts show IDs or URLs. Public feeds accepts feed URLs. Ignored for Charts, Genres, keyword searches, and New shows.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Storefront country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Two-letter Apple Podcasts country code, such as US or GB. Applies to all result types.",
            "default": "US"
          },
          "language": {
            "title": "Storefront language",
            "type": "string",
            "description": "Use a language supported by the storefront, such as en-US. Leave blank to use the storefront language."
          },
          "genreIds": {
            "title": "Genre IDs",
            "type": "array",
            "description": "Limit Shows keyword searches and show or episode Charts to these Apple Podcasts genres. Use Genres to find IDs. Leave empty for all genres.",
            "items": {
              "type": "string"
            }
          },
          "contentRating": {
            "title": "Content rating",
            "enum": [
              "all",
              "clean",
              "explicit"
            ],
            "type": "string",
            "description": "For Shows and Episodes, choose clean content, explicit content, or both.",
            "default": "all"
          },
          "listingType": {
            "title": "Channel listing",
            "enum": [
              "all",
              "free",
              "paid"
            ],
            "type": "string",
            "description": "For Channels and channel Charts, choose all, free, or paid public listings. Paid listings include public catalog data only.",
            "default": "all"
          },
          "maxItems": {
            "title": "Maximum records",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many records. Leave blank to collect all available records for the chosen result type until the source is exhausted."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}