So scrapst du TMDB 2026 (API & Python)

TMDB ist eine der wenigen Plattformen in dieser Serie mit einer echten, kostenlosen, offenen Self-Service-API — du kannst dich registrieren und in wenigen Minuten einen Key bekommen, und sie deckt das meiste ab, was ein Movie/TV-Produkt braucht. Die ehrliche Frage ist also nicht „hat TMDB eine API", sondern „wann willst du trotzdem eine Scraping-API." Dieser Guide behandelt TMDBs eigene API, No-Code-Optionen und eine strukturierte Multi-Plattform-API, jeweils mit der rechtlichen Realität vorab.

Warum TMDB-Daten nutzen?

TMDBs Movie-, TV- und People-Daten sind die Grundlage für einen großen Teil des Film/TV-Tooling und treiben an:

• Katalog-Anreicherung — kanonischen Title, Cast, Genre und Release-Daten an eine Media-App, Watchlist oder ein internes Dataset hängen.
• Recommendation und Discovery — Genre-, Ära- oder „Now Playing"-artige Browsing- und Discovery-Features bauen.
• Talent- und Filmografie-Tracking — das Werk eines Regisseurs oder einer Schauspielerin über Movie- und TV-Credits hinweg verfolgen.
• Plattformübergreifende Rating-Recherche — TMDBs eigenes Rating mit IMDb- oder Metacritic-Scores kombinieren für ein vollständigeres Bild der Rezeption als eine einzelne Quelle liefert.
• Poster- und Metadaten-Pipelines — TMDBs Poster- und Profilbild-CDN ist ein gängiger Backing-Store für Artwork in Media-Apps.

Ist es legal, TMDB zu nutzen/scrapen?

Option 1: TMDBs eigene kostenlose API (und ihre echten Grenzen)

TMDBs Developer-API ist real und funktioniert. Registriere einen Account, fordere einen Key in den API-Settings deines Accounts an und rufe ihn direkt auf — kein Scraping nötig:

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"

Das ist ein legitimer, kostenloser Weg, an TMDBs eigenen Movie- und TV-Katalog zu kommen — Title, Overview, Cast, Crew, Genres und TMDBs Rating. TMDBs CDN deckelt Requests bei rund 50 Requests/Sekunde und 20 Connections pro IP, was für ein Single-Plattform-Lookup-Tool großzügig ist.

Wo es für eine größere Pipeline weniger relevant wird:

• Es ist TMDBs Katalog, nicht die gerenderte Page. Die API gibt TMDBs eigene strukturierte Records zurück — nicht das „ähnliche Titles"-Modul, Popularitäts-Charts oder User-Review-Threads, so wie sie Besuchern tatsächlich auf themoviedb.org angezeigt werden; manches davon existiert nur als Page-Level-Präsentation.
• Ein separater Account, Key und Schema pro Plattform. Wenn dein Produkt auch IMDb, Letterboxd oder Metacritic zieht, ist TMDBs API ein weiteres Auth-Modell, ein weiteres Rate-Limit und eine weitere Response-Struktur, die du neben den anderen pflegen musst.
• Die kommerziellen Bedingungen brauchen einen echten Blick. Nicht-kommerzielle Nutzung ist mit Attribution kostenlos; alles, was Nutzer bezahlen lässt, TMDB-Content redistribuiert oder sonst kommerziell ist, braucht vorher TMDBs schriftliches Okay — lohnt sich, gegen deinen konkreten Use Case zu prüfen, bevor du darauf aufbaust.

Option 2: No-Code-Tools

Marketplace-Scraper-Actors und No-Code-Connectors gibt es für TMDB-nahe Workflows — meist wrappen sie TMDBs eigene API statt der Seite, da die Seite selbst Scraping untersagt. Für einen einmaligen Abzug oder einen Spreadsheet-Export sind sie okay, aber für eine geplante Pipeline fügen sie eine Indirektionsebene über eine API hinzu, die du sonst direkt aufrufen könntest, und sie lösen auch nicht das Multi-Plattform-Schema-Problem.

Option 3: Eine strukturierte TMDB-API (via Crawlora)

Wenn du TMDB neben anderen Plattformen in einer normalisierten Form willst — derselbe Auth-Header, konsistentes JSON —, liefert dir das eine TMDB scraping API. Suche über Movies, TV und People:

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" }
    ]
  }
}

Löse dann die id auf und hol Movie-, TV- oder Person-Detail in 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"]

Movie-Detail ist normalisiertes JSON mit Cast, Crew und Rating (echte Felder — prüf die docs):

{
  "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 funktioniert nach demselben Muster, mit first_air_year, last_air_year und number_of_episodes statt Runtime und Budget. /tmdb/movie/list und /tmdb/tv/list liefern kuratierte, filterbare Listen (category, sort_by, with_genres, min_rating, date_from/date_to und mehr) für Browsing und Discovery, und /tmdb/person gibt Bio, Geburtsdatum, Foto und Filmografie per id zurück — mit /tmdb/person/list zum Durchstöbern von Personen. Speichere eine Zeile pro Title (oder pro Person) und lass es nach Zeitplan erneut laufen.

Was du sammeln kannst

Öffentliche TMDB-Katalogdaten: Multi-Type-Search (Movie, TV oder Person, mit id und url); Movie- und TV-Detail (Title, Tagline, Overview, Release-Datum, Runtime oder Episoden-Anzahl, Genres, Länder, Status, Budget/Revenue bei Movies, Poster, Rating-Durchschnitt/-Anzahl, Top-Crew und Cast mit Charakternamen); kuratierte und filterbare Movie/TV-Listen (Now Playing, Popular, Top Rated, Upcoming, Airing Today sowie Genre-/Rating-/Datumsfilter); und Person-Detail (Bio, Geburtsdatum, Foto und Filmografie über Movie- und TV-Credits hinweg).

Grenzen und typische Herausforderungen

• Wisse, welche Tür du benutzt. TMDBs eigene API ist kostenlos und legitim für nicht-kommerzielle Single-Plattform-Arbeit; die themoviedb.org-Website selbst zu scrapen widerspricht auf jeden Fall ausdrücklich TMDBs Bedingungen.
• Kommerzielle Nutzung braucht ein echtes Gespräch mit TMDB. Attribution allein deckt nur nicht-kommerzielle Nutzung ab; alles Kommerzielle — auch ein Produkt auf Basis einer normalisierten API, die TMDB-Daten enthält — solltest du gegen TMDBs API Terms of Use prüfen und, wo nötig, direkt mit TMDB lizenzieren.
• Die API ist TMDBs Katalog, nicht alles auf der Page. Manche Page-gerenderten Inhalte (Review-Threads, „ähnliche Titles" wie sie Nutzern angezeigt werden, Live-Popularitäts-Charts) sind kein direktes API-Feld.
• Fan-out pro Record. Ein vollständiger Record (Title plus Cast, Crew und Rating) ist ein Call pro id; einen Katalog aufzubauen heißt, ids aus Search- oder List-Endpoints zu iterieren.
• Nur öffentliche Daten. Das sammelt, was TMDB bereits über seine API exponiert — nie ein Weg, um TMDBs Site-Restriktionen oder ihre kommerziellen Lizenzbedingungen zu umgehen.

Wo das eingesetzt wird

• Katalog-Anreicherung — kanonischen Title, Cast und Rating-Daten an ein Media-Produkt hängen.
• Discovery-Oberflächen — „Now Playing", Genre-Browsing und Recommendation-Features antreiben.
• Plattformübergreifende Rezeptions-Recherche — TMDBs Rating mit IMDb- und Metacritic-Scores in einem normalisierten Schema kombinieren.
• Talent-Tracking — die Filmografie eines Regisseurs oder einer Schauspielerin über Movie- und TV-Arbeit hinweg verfolgen.

Sources

Leg los mit dem Sammeln

Probier es zuerst kostenlos aus: jage eine beliebige öffentliche URL durch den Free Web Scraper oder prüfe mit dem Anti-Bot Checker, ob eine Seite Bots blockiert — ohne Anmeldung.

Teste die Search-, Movie- und Person-Endpoints im Playground, sieh dir das Schema in den API docs an und wirf einen Blick aufs pricing. TMDB sagt dir, was ein Title ist, wer ihn gemacht hat und wie TMDBs eigene Community ihn bewertet hat; IMDb liefert die Standard-Rating- und Review-Baseline des Webs dazu, und Metacritic ergänzt Kritiker-gegen-User-Scoring — kombiniere sie für ein vollständiges Rezeptionsbild, statt einer einzelnen Quelle zu vertrauen. Siehe auch how to choose a web scraping API und is web scraping legal.