ポッドキャストの発見
Spotify Podcastsエンドポイントを使えば、「ポッドキャストの発見」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Spotifyポッドキャストの発見ページ、チャート、番組、エピソードページを構造化データに変換し、リサーチとエージェント向けアプリケーションに活用できます。
構造化APIエンドポイント経由で、Spotify Podcastsのホームページ、カテゴリ、チャート、番組、エピソード、レコメンド、検索データを収集できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
42
サンプル数
8
ライブカタログスナップショット
稼働エンドポイント
8
メソッド
GET
必須パラメータ
9
スキーマ参照
8
{
"platform": "Spotify Podcasts",
"endpoint": "spotify-podcasts-categories",
"method": "GET",
"path": "/spotify-podcasts/categories",
"auth": "apiKey"
}関連ユースケース
ユースケース
構造化APIエンドポイント経由で、Spotify Podcastsのホームページ、カテゴリ、チャート、番組、エピソード、レコメンド、検索データを収集できます。
Spotify Podcastsエンドポイントを使えば、「ポッドキャストの発見」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Spotify Podcastsエンドポイントを使えば、「番組・エピソードのリサーチ」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Spotify Podcastsエンドポイントを使えば、「ポッドキャストチャートのモニタリング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のSpotify Podcastsエンドポイントカタログから取得しています（エンドポイント8件、ドキュメント化されたリクエストパラメータ42個、公開レスポンススキーマ8件）。DocsとPlaygroundが参照しているカタログと同じものです。
Spotify Podcastsのエンドポイントは8件、6つのリクエストファミリーに分類されています（Show、Categories、Chartsほか3件）。
これらのSpotify Podcastsエンドポイントには42個のリクエストパラメータがドキュメント化されており、うち9個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
8件のSpotify Podcastsエンドポイントのうち8件が実際のサンプルレスポンスを、8件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Spotify Podcastsのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、429、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Spotify Podcastsのエンドポイントは8個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/spotify-podcasts/show
/spotify-podcasts/categories
/spotify-podcasts/charts
/spotify-podcasts/episode
/spotify-podcasts/home
/spotify-podcasts/search
エンドポイントカタログ
/spotify-podcasts/categoriesReturns normalized Spotify podcast category sections and items from Spotify's all-categories browsePage Pathfinder response.
レスポンスに関する注記
- Upstream token, app config, client token, or Pathfinder failures return `503`. - The response uses the same normalized section and item shape as `/api/v1/spotify-podcasts/home`. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:page:0JQ5DArNBzkmxXHCqFLx2U", "title": "All podcast categories", "sections": [ { "uri": "spotify:section:example", "title": "Categories", "items": [ { "uri": "spotify:page:example", "title": "Arts" } ] } ], "meta": { "operationName": "browsePage", "sectionCount": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
MCPツール spotify_podcasts_categories
/spotify-podcasts/chartsReturns normalized Spotify podcast chart rankings from podcastcharts.byspotify.com. The chart and region parameters are validated against Spotify's supported podcast chart slugs and countries. Category charts are available only in au, br, de, gb, mx, se, and us.
レスポンスに関する注記
- Invalid `chart` or `region` values return `400`. - `top-podcasts`, `top-episodes`, and `trending` support all listed regions. Category charts support `au`, `br`, `de`, `gb`, `mx`, `se`, and `us`. - `top-episodes` items include episode fields plus the parent show fields when Spotify returns them. - Upstream chart failures return `503`. - `items[].rank` is assigned from the upstream array order. Example response: ```json { "code": 200, "msg": "OK", "data": { "chart": "religion-spirituality", "chartName": "Religion & Spirituality", "chartType": "category", "region": "us", "regionName": "United States", "limit": 100, "items": [ { "rank": 1, "uri": "spotify:show:4Pppt42NPK2XzKwNIoW7BR", "rankMove": "UNCHANGED", "name": "The Bible in a Year (with Fr. Mike Schmitz)", "publisher": "Ascension", "imageUrl": "https://i.scdn.co/image/example", "description": "A podcast description.", "externalUrl": "https://open.spotify.com/show/4Pppt42NPK2XzKwNIoW7BR" } ], "meta": { "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/religion-spirituality?limit=100®ion=us", "count": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
MCPツール spotify_podcasts_charts
/spotify-podcasts/episodeReturns normalized public episode metadata from Spotify's getEpisodeOrChapter Pathfinder response, with episode page, embed page, and anonymous oEmbed fallbacks when Pathfinder is unavailable. Provide either uri or id; defaults to a known public episode when omitted.
レスポンスに関する注記
- Invalid Spotify episode IDs or URLs return `400`. - Pathfinder, upstream page, embed, and oEmbed failures, or parser drift across all sources, return `503`. - The response includes episode metadata, HTML descriptions, release precision, playability and paywall hints, audio preview URLs, video thumbnails, transcript counts, share links, and parent show metadata when available. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:episode:2C2Y5kNq7qCVOVhbA0G3os", "id": "2C2Y5kNq7qCVOVhbA0G3os", "type": "Episode", "name": "#2496 - Julia Mossbridge", "releaseDate": "2026-05-08T17:00:00Z", "durationMs": 9761982, "isExplicit": true, "isPlayable": true, "playabilityReason": "PLAYABLE", "mediaTypes": ["AUDIO", "VIDEO"], "imageUrl": "https://i.scdn.co/image/example", "videoThumbnailUrl": "https://i.scdn.co/image/video-example", "externalUrl": "https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os", "shareUrl": "https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os", "previewAudioUrl": "https://audio-preview.spotifycdn.com/example.mp3", "previewAudioUrls": ["https://audio-preview.spotifycdn.com/example.mp3"], "transcriptCount": 1, "show": { "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk", "name": "The Joe Rogan Experience", "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk" }, "meta": { "operationName": "getEpisodeOrChapter", "appVersion": "1.2.90.373.g86862e17", "sourceUrl": "https://api-partner.spotify.com/pathfinder/v2/query", "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
MCPツール spotify_podcasts_episode
/spotify-podcasts/homeReturns normalized sections and items from Spotify's podcast home browsePage Pathfinder response.
レスポンスに関する注記
- Upstream token, app config, client token, or Pathfinder failures return `503`. - The response includes normalized section titles, item metadata, image assets, external Spotify URLs, and fetch metadata. Example response: ```json { "code": 200, "msg": "OK", "data": { "uri": "spotify:genre:podcasts-web", "title": "Podcasts", "sections": [ { "uri": "spotify:section:example", "title": "Featured", "items": [ { "uri": "spotify:show:1QQJ7FElLE0K6CIfZNCxU4", "type": "Podcast", "title": "Example Show", "externalUrl": "https://open.spotify.com/show/1QQJ7FElLE0K6CIfZNCxU4" } ] } ], "meta": { "operationName": "browsePage", "sectionCount": 1, "fetchedAt": "2026-05-13T15:22:41Z" } } } ```
MCPツール spotify_podcasts_home
/spotify-podcasts/searchReturns normalized Spotify podcast shows, episodes, and top results for a search term.
MCPツール spotify_podcasts_search
/spotify-podcasts/showReturns normalized podcast show metadata from Spotify Pathfinder.
MCPツール spotify_podcasts_show
/spotify-podcasts/show/episodesReturns normalized podcast episodes for a Spotify show URI.
MCPツール spotify_podcasts_show_episodes
/spotify-podcasts/show/recommendationsReturns normalized related Spotify shows and episodes from Spotify's show recommendations response.
MCPツール spotify_podcasts_show_recommendations
関連API
Audio & Podcast Platforms
Build audio intelligence workflows from Spotify catalog and public profile signals without maintaining Spotify scrapers.
Audio & Podcast Platforms
Turn SoundCloud's tracks, playlists, user profiles, and search results into structured JSON — plays, likes, comments, artwork, and uploader details — as normalized data. Credential-free.
Audio & Podcast Platforms
Extract Apple Podcasts chart rankings, related-show recommendations, curated New shelves, show metadata, episodes, and search results as structured JSON for podcast discovery, chart tracking, and catalog enrichment.
Spotify Podcastsのスクレイピング方法
Spotify公式のWeb APIは、すでにIDを持っている番組とエピソードをカバーしますが、ポッドキャストチャートや自社アプリでレンダリングされる閲覧ページはカバーしていません。Crawloraの8個のSpotify Podcastsエンドポイントは、検索、カテゴリ、ホームページとチャートの項目、番組メタデータ、エピソード、レコメンドデータを正規化JSONとして返します。
フリーテキストのqでポッドキャストを検索するか、カテゴリとホームページのエンドポイントを読み取って、Spotifyがアプリ内でレンダリングするセクション別閲覧ページを取得します。
チャートエンドポイントはtop-podcasts、top-episodes、trendingなどのchartパラメータに加え、comedy、news、true-crimeなどジャンル別チャート、ドキュメントに記載の2文字の地域コードを受け付けます。
番組メタデータと番組エピソードのエンドポイントはSpotifyのuriを受け付け、エピソード詳細はuriまたはidを受け付けます。
番組レコメンドエンドポイントは、あるuriに対して関連番組を返します。これは平面的な一覧ではなく、トピックの関係グラフを構築する方法です。
FAQ
Spotifyの Web APIは、すでにIDを持っている番組とエピソードを公開していますが、ポッドキャストチャート、カテゴリ閲覧ページ、ホームページのセクションは含まれません。これらのデータはSpotify自身のWebクライアントに由来し、まさにCrawloraのエンドポイントが読み取り正規化している内容です。
top-podcasts、top-episodes、trendingに加え、arts、business、comedy、education、fiction、health-fitness、history、leisure、music、news、religion-spirituality、science、society-culture、sports、technology、true-crime、tv-filmなどのジャンル別チャートをカバーします。それぞれ2文字の地域コードを受け付けます。
Spotifyのuriです。検索とチャートのレスポンスがそれを返すため、通常のフローはまず検索またはチャートを確認し、次にuriを番組・エピソード・レコメンドの各エンドポイントに渡すというものです。