ポッドキャストの発見
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契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/spotify-podcasts/show
/spotify-podcasts/categories
/spotify-podcasts/charts
/spotify-podcasts/episode
/spotify-podcasts/home
/spotify-podcasts/search
エンドポイントカタログ
/spotify-podcasts/categoriesReturns the Spotify podcast categories page as sections of items such as Arts, for `uri` (default `spotify:page:0JQ5DArNBzkmxXHCqFLx2U`). Each section has a title, `totalCount` and items with title, image and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
レスポンスに関する注記
- Upstream failures return `503`. - The response uses the same section and item shape as `/api/v1/spotify-podcasts/home`.
MCPツール spotify_podcasts_categories
/spotify-podcasts/chartsReturns 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.
MCPツール spotify_podcasts_charts
/spotify-podcasts/episodeReturns public episode metadata. Provide either uri or id; defaults to a known public episode when omitted.
レスポンスに関する注記
- Invalid Spotify episode IDs or URLs return `400`. - Upstream failures 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.
MCPツール spotify_podcasts_episode
/spotify-podcasts/homeReturns the Spotify podcasts home page as sections of items, for `uri` (default `spotify:genre:podcasts-web`). Each section has a title and items with type, title, publisher, images and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
レスポンスに関する注記
- Upstream failures return `503`. - The response includes section titles, item metadata, image assets, external Spotify URLs, and fetch metadata.
MCPツール spotify_podcasts_home
/spotify-podcasts/searchSearches Spotify podcasts for `q`, returning matching `shows`, `episodes` and `topResults`, with counts in `meta`. `limit` and `number_of_top_results` run 1 to 50. Optional flags (`include_pre_releases`, `include_audiobooks`, `include_authors`) widen the results. Episodes carry duration and release date; shows carry publisher.
MCPツール spotify_podcasts_search
/spotify-podcasts/showReturns metadata for one Spotify podcast show by `uri` (default `spotify:show:1QQJ7FElLE0K6CIfZNCxU4`): name, publisher, description, media type, explicit flag, `totalEpisodes`, cover images and Spotify URL. The two `include_` flags request extra content capability and content rating fields when Spotify supplies them.
MCPツール spotify_podcasts_show
/spotify-podcasts/show/episodesReturns the episodes of a Spotify podcast by show URI, with `offset` and `limit` (1-50). Each episode has its name, description, release date, duration in milliseconds, explicit and playable flags, Spotify URI, external URL and images; `total` gives the show's episode count.
MCPツール spotify_podcasts_show_episodes
/spotify-podcasts/show/recommendationsLists shows and episodes that Spotify recommends alongside a podcast show given by `uri`. Each recommendation has a type, title, publisher, description, images and Spotify URL, and `meta.count` gives the number returned. The response echoes the show `uri` it was requested for.
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に対して関連番組を返します。これは平面的な一覧ではなく、トピックの関係グラフを構築する方法です。
charts returned chart top-podcasts, region us, a limit of 100 and 200 items, each with rank, a spotify:show URI, rankMove (UNCHANGED for the first) and publisher. Count the rows you receive.
search for history returned a limit of 30, 24 topResults (the first The Rest Is History, publisher Goalhanger) and 4 shows. The sections overlap in content, so dedupe by uri.
クライアントライブラリ
お使いの言語向けの Spotify 専用クライアントをインストールできます。各パッケージはこのページの Spotify エンドポイントに対応し、APIキーを使って Crawlora のホスト型 API を呼び出します。
npm install @crawlora-org/spotifynpmgo get github.com/Crawlora-org/crawlora-spotifypkg.go.devgem install crawlora-spotifyRubyGemsnet.crawlora:crawlora-spotifyMaven Centralcomposer require crawlora/spotifyPackagistcargo add crawlora-spotifycrates.ioエージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Spotify Podcasts のデータを JSON として取得できます。Spotify Podcasts に対応するスキル:
Discovers and compares public podcast shows, episodes, charts, rankings, and related programs using Apple Podcasts and Spotify Podcasts through the…
npx skills add github.com/Crawlora-org/crawlora-skills --skill podcast-discovery-researchMap podcast topics across public show and episode samples with Crawlora Apple Podcasts and Spotify tools. Use for a podcast editorial landscape…
npx skills add github.com/Crawlora-org/crawlora-skills --skill podcast-topic-landscapeResearches music, artists, playlists, and podcasts via the Crawlora API — Spotify tracks/albums/artists/playlists/profiles, Spotify Podcasts, Apple…
npx skills add github.com/Crawlora-org/crawlora-skills --skill music-podcast-researchFAQ
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を番組・エピソード・レコメンドの各エンドポイントに渡すというものです。
Not exactly. On 2026-10-27 the response reported limit 100 and returned 200 items.