TMDBを2026年にスクレイピングする方法（API・Python）

TMDB は、このシリーズの中でも数少ない、本物のセルフサービス型無料公式 API を持つプラットフォームです — 数分で登録してキーを取得でき、映画/TV 系プロダクトに必要なものの大半をカバーします。だから正直な問いは「TMDB に API はあるか」ではなく、「それでもスクレイピング API を使いたくなるのはどんなときか」です。このガイドでは TMDB 自身の API、ノーコードの選択肢、そして構造化されたマルチプラットフォーム API を取り上げ、それぞれの法的な実態を最初に示します。

なぜ TMDB のデータを使うのか？

TMDB の映画・TV・人物データは、映画/TV 関連ツールの大部分を支えており、次のような用途を実現します。

• カタログの拡充 — 正規のタイトル、キャスト、ジャンル、公開日データをメディアアプリやウォッチリスト、社内データセットに追加できます。
• レコメンドと発見 — ジャンル、時代、「上映中」といったスタイルの閲覧・発見機能を構築できます。
• タレント・フィルモグラフィーの追跡 — 監督や俳優の映画・TV クレジット全体にわたる作品歴を追跡できます。
• プラットフォーム横断の評価リサーチ — TMDB 自身の評価を IMDb や Metacritic のスコアと組み合わせることで、単一のソースよりも全体的な評価像を把握できます。
• ポスター・メタデータのパイプライン — TMDB のポスターやプロフィール画像 CDN は、メディアアプリのアートワークの裏側でよく使われるストアです。

TMDB を利用／スクレイピングするのは合法か？

選択肢1: TMDB 自身の無料 API（そして実際の限界）

TMDB の開発者 API は本物で、実際に動作します。アカウントを登録し、アカウントの API 設定からキーをリクエストして、直接呼び出せます — スクレイピングは不要です。

curl "https://api.themoviedb.org/3/movie/27205" \
  -H "Authorization: Bearer YOUR_TMDB_V4_READ_ACCESS_TOKEN"

# or with the v3 query-param key:
curl "https://api.themoviedb.org/3/movie/27205?api_key=YOUR_TMDB_API_KEY"

これは TMDB 自身の映画・TV カタログ — タイトル、概要、キャスト、クルー、ジャンル、TMDB の評価 — を取得する正当かつ無料の方法です。TMDB の CDN はリクエストを1秒あたり約50リクエスト、IP あたり20接続に制限していますが、単一プラットフォームのルックアップツールとしては十分寛容な制限です。

より大規模なパイプラインになると、重要性が薄れてくる点があります。

• これは TMDB のカタログであり、レンダリングされたページではない。 API が返すのは TMDB 自身の構造化されたレコードです — themoviedb.org の訪問者に実際に表示されている「類似タイトル」モジュール、人気度チャート、ユーザーレビュースレッドは提供されません。その一部はページレベルの表現としてしか存在しません。
• プラットフォームごとに別々のアカウント、キー、スキーマが必要。 自分の製品が IMDb、Letterboxd、Metacritic からもデータを取得しているなら、TMDB の API はさらにもう1つの認証モデル、もう1つのレート制限、もう1つのレスポンス形式を、他と並行して維持することになります。
• 商用条件はきちんと読む必要がある。 非商用利用はクレジット表示があれば無料ですが、ユーザーに課金する、TMDB のコンテンツを再配布する、あるいはその他の形で商用となる場合は、事前に TMDB の書面による承認が必要です。構築する前に、自分の実際のユースケースと照らし合わせて確認する価値があります。

選択肢2: ノーコードツール

TMDB に関連するワークフロー向けに、マーケットプレイスのスクレイパーアクターやノーコードコネクタが存在します — サイト自体がスクレイピングを禁止しているため、その多くはサイトではなく TMDB 自身の API をラップしています。単発の取得やスプレッドシートへのエクスポートには十分ですが、スケジュール実行するパイプラインでは、本来なら直接呼び出せる API に間接層を1つ加えることになり、マルチプラットフォームのスキーマ問題も解決しません。

選択肢3: 構造化された TMDB API（Crawlora経由）

TMDB を他のプラットフォームと一緒に、同じ認証ヘッダー・一貫した JSON という1つの正規化された形で扱いたいなら、TMDB スクレイピング API がそれを実現します。映画・TV・人物を横断して検索できます。

curl "https://api.crawlora.net/api/v1/tmdb/search?query=inception" \
  -H "x-api-key: $CRAWLORA_API_KEY"

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "inception",
    "page": 1,
    "has_next_page": true,
    "results": [
      { "type": "movie", "id": "27205", "title": "Inception", "release_date": "2010-07-15", "overview": "Cobb, a skilled thief...", "uri": "https://www.themoviedb.org/movie/27205-inception" }
    ]
  }
}

続いて id を解決し、映画・TV・人物の詳細を Python で取得します。

import requests
h = {"x-api-key": "YOUR_API_KEY"}
base = "https://api.crawlora.net/api/v1/tmdb"

hits = requests.get(f"{base}/search", headers=h, params={"query": "inception"}).json()["data"]["results"]
movie_id = hits[0]["id"]

movie = requests.get(f"{base}/movie/{movie_id}", headers=h).json()["data"]
now_playing = requests.get(f"{base}/movie/list", headers=h, params={"category": "now_playing"}).json()["data"]

映画詳細は、キャスト、クルー、評価を含む正規化された JSON です（実際のフィールドです — ドキュメントを確認してください）。

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "27205",
    "title": "Inception",
    "tagline": "Your mind is the scene of the crime.",
    "release_date": "2010-07-15",
    "year": 2010,
    "runtime_minutes": 148,
    "genres": ["Action", "Science Fiction", "Adventure"],
    "countries": ["United States", "United Kingdom"],
    "status": "Released",
    "budget": 160000000,
    "revenue": 839030630,
    "rating": { "average": 8.372, "count": 39524, "review_count": 8 },
    "top_crew": [{ "name": "Christopher Nolan", "slug": "525", "jobs": ["Director", "Writer"] }],
    "cast": [{ "name": "Leonardo DiCaprio", "slug": "6193", "character": "Dom Cobb" }],
    "uri": "https://www.themoviedb.org/movie/27205-inception"
  }
}

TV も同じ形で、runtime と budget の代わりに first_air_year、last_air_year、number_of_episodes が含まれます。/tmdb/movie/list と /tmdb/tv/list は、閲覧・発見のためのキュレーションされたフィルタ可能なリスト（category、sort_by、with_genres、min_rating、date_from/date_to など）を返し、/tmdb/person は id によって経歴、生年月日、写真、フィルモグラフィーを返します — 人物を閲覧するには /tmdb/person/list を使います。タイトル（または人物）1件につき1行を保存し、スケジュールを組んで再実行しましょう。

収集できるもの

公開されている TMDB のカタログデータです。複数タイプ検索（映画・TV・人物、id と url を含む）、映画・TV 詳細（タイトル、タグライン、概要、公開日、上映時間またはエピソード数、ジャンル、制作国、ステータス、映画の場合は予算/興行収入、ポスター、評価の平均/件数、主要クルー、キャラクター名付きのキャスト）、キュレーションされたフィルタ可能な映画/TV リスト（上映中、人気、高評価、公開予定、本日放送、およびジャンル/評価/日付によるフィルタ）、そして人物詳細（経歴、生年月日、写真、映画・TV クレジット全体にわたるフィルモグラフィー）です。

制約とよくある課題

• どの入口を使っているかを把握する。 TMDB 自身の API は、非商用の単一プラットフォーム作業には無料かつ正当な選択肢です。themoviedb.org サイト自体をスクレイピングすることは、いずれにせよ TMDB の規約に明確に反します。
• 商用利用には TMDB との実際の話し合いが必要。 クレジット表示だけでカバーされるのは非商用利用のみです。TMDB のデータを含む正規化 API の上に構築された製品を含め、商用となるものはすべて TMDB の API 利用規約と照らし合わせて確認し、必要な場合は TMDB と直接ライセンス契約を結ぶ必要があります。
• API は TMDB のカタログであり、ページ上のすべてではない。 レビュースレッド、ユーザーに表示される「類似タイトル」、ライブの人気度チャートといった一部のページ表示コンテンツは、API の直接的なフィールドとしては存在しません。
• レコードごとのファンアウト。 フルレコード（タイトルにキャスト、クルー、評価を加えたもの）は id ごとに1回の呼び出しが必要です。カタログを構築するには、検索やリストのエンドポイントから得た id を反復処理する必要があります。
• 公開データのみ。 これは TMDB が API を通じてすでに公開しているものを収集するだけであり、TMDB のサイト制限や商用ライセンス条件を回避する手段では決してありません。

どこで使われるか

• カタログの拡充 — 正規のタイトル、キャスト、評価データをメディア製品に追加できます。
• 発見画面 — 「上映中」、ジャンル別閲覧、レコメンド機能を支えます。
• プラットフォーム横断の評価リサーチ — TMDB の評価を IMDb や Metacritic のスコアと1つの正規化されたスキーマで組み合わせられます。
• タレント追跡 — 監督や俳優のフィルモグラフィーを映画・TV 作品全体にわたって追跡できます。

出典

収集を始める

まずは無料でお試しください: 任意の公開 URL を無料ウェブスクレイパーに通すか、アンチボットチェッカーでサイトがボットをブロックするかどうかを確認できます。サインアップ不要です。

プレイグラウンドで検索・映画・人物のエンドポイントを試し、API ドキュメントでスキーマを確認し、料金をご覧ください。TMDB はタイトルが何であるか、誰が作ったか、そして TMDB 自身のコミュニティがどう評価したかを教えてくれます。IMDb はウェブのデフォルトの評価・レビューの基準を加え、Metacritic は批評家対ユーザーのスコアリングを加えます — 単一のソースを信頼するのではなく、組み合わせて全体的な評価像を得ましょう。あわせてウェブスクレイピング API の選び方とウェブスクレイピングは合法かもご覧ください。