{
  "openapi": "3.0.1",
  "info": {
    "title": "Apple Podcasts Scraper — Shows, Episodes, Reviews & Host Leads",
    "description": "Scrape Apple Podcasts: search shows, full show details, top charts, a publisher's whole catalog, episodes and reviews. Rich RSS data — owner email, website, publishing cadence, active/dormant flags — plus opt-in host-contact leads and monitoring. No login, no key, no browser.",
    "version": "0.1",
    "x-build-id": "hEfobLl5PZYcqg95a"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapesage~apple-podcasts-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~apple-podcasts-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapesage-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/scrapesage~apple-podcasts-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapesage-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",
              "showDetails",
              "topCharts",
              "publisherShows",
              "reviews"
            ],
            "type": "string",
            "description": "Pick a job. Search finds shows by keyword. Show details pulls full records (with RSS data) for specific shows. Top charts lists the top podcasts in a category. Publisher shows returns a publisher's whole catalog. Reviews pulls listener reviews for specific shows.",
            "default": "search"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords to search Apple Podcasts for, e.g. `true crime`, `b2b marketing`, `startup founders`. One row per term. (Mode: Search.)",
            "items": {
              "type": "string"
            }
          },
          "podcastIds": {
            "title": "Podcast IDs / URLs / RSS feeds",
            "type": "array",
            "description": "Apple Podcasts IDs (e.g. `1138869817`), full Apple Podcasts URLs (`https://podcasts.apple.com/.../id1138869817`), or direct RSS feed URLs. Used by Show details and Reviews modes. Reviews need an Apple ID/URL (not a feed URL).",
            "items": {
              "type": "string"
            }
          },
          "genre": {
            "title": "Category",
            "enum": [
              "ALL",
              "1301",
              "1321",
              "1303",
              "1304",
              "1483",
              "1511",
              "1487",
              "1307",
              "1305",
              "1502",
              "1310",
              "1489",
              "1314",
              "1533",
              "1324",
              "1545",
              "1318",
              "1488",
              "1309"
            ],
            "type": "string",
            "description": "Category for the top chart, or `All podcasts` for the overall chart. (Mode: Top charts.)",
            "default": "ALL"
          },
          "artistIds": {
            "title": "Publisher (artist) IDs / URLs",
            "type": "array",
            "description": "Numeric Apple artist IDs (e.g. `1439215748`) or Apple Podcasts artist URLs. Returns every show in that publisher's catalog. (Mode: Publisher shows.)",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerQuery": {
            "title": "Max shows per query",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Cap the number of shows returned per search term, chart, or publisher (Apple returns up to 200).",
            "default": 50
          },
          "fullDetails": {
            "title": "Enrich chart shows with full details",
            "type": "boolean",
            "description": "For Top charts, open each ranked show for the complete record. Search and Publisher modes already return full records. Turn off for a faster, lighter chart listing.",
            "default": true
          },
          "enrichFromRss": {
            "title": "Enrich from RSS feed (owner email, cadence, analytics)",
            "type": "boolean",
            "description": "Fetch each show's public RSS feed to add the fields Apple's API omits: owner name & EMAIL, website, language, full categories, plus derived analytics (episode count, last-episode date, publishing cadence, average duration, active/dormant). One extra request per show.",
            "default": true
          },
          "includeEpisodes": {
            "title": "Include episodes",
            "type": "boolean",
            "description": "Also output episode records (type `episode`) from each show's RSS feed — title, date, duration, audio URL, season/episode numbers, type and description. In monitoring mode this returns only NEW episodes since the last run.",
            "default": false
          },
          "maxEpisodesPerShow": {
            "title": "Max episodes per show",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many recent episodes to pull per show when 'Include episodes' is on.",
            "default": 10
          },
          "enrichHostContacts": {
            "title": "Enrich host contacts (crawl website for emails, phone, socials)",
            "type": "boolean",
            "description": "Opt-in lead enrichment: visit each show's own public website (home + a contact/about page) and extract contact emails, phone numbers and social links — for podcast guesting, sponsorship and PR outreach. Only runs for shows that have a website.",
            "default": false
          },
          "maxReviewsPerShow": {
            "title": "Max reviews per show",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many reviews to fetch per show, newest first by default. Apple's public review feed exposes roughly the latest 500 per show (50 per page, 10 pages). (Mode: Reviews.)",
            "default": 100
          },
          "reviewsSort": {
            "title": "Sort reviews by",
            "enum": [
              "mostrecent",
              "mosthelpful"
            ],
            "type": "string",
            "description": "Order in which reviews are pulled. (Mode: Reviews.)",
            "default": "mostrecent"
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter Apple storefront code (e.g. `us`, `gb`, `de`, `au`). Affects search results, chart rankings and the review pool.",
            "default": "us"
          },
          "monitorMode": {
            "title": "Monitoring mode — only new records",
            "type": "boolean",
            "description": "Remember what was already returned and emit ONLY records not seen in previous runs (new shows for a search/chart/publisher, new episodes per show, or new reviews per show). Pairs with Apify Schedules to track changes over time.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store that holds the 'already seen' ids for monitoring mode. Use a different name per tracked target/query to keep their histories separate.",
            "default": "apple-podcasts-monitor"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Maximum parallel requests. Lower it if you hit rate limits on very large runs.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Apple's public endpoints and most podcast RSS feeds have no hard anti-bot, so the default Apify proxy is plenty; switch to residential for very large or high-frequency runs.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}