Die omdb steht unter freier Lizenz. Deshalb ist es möglich, die Daten unter Berücksichtigung der Lizenzbestimmungen weiterzunutzen.
Eine omdb API existiert momentan noch nicht. Allerdings gibt es die folgenden Daten im CSV-Format. Sie erhalten jeweils Teile der Datenbank und werden normalerweise mehrmals täglich aktualisiert, allerdings nur, wenn sich an den Daten auch etwas geändert hat. Die Bezeichnung “movies” steht bei allen Angaben (außer der Datei “all_movies.csv”) auch für Serien bzw. deren Episoden.- all_movies.csv.bz2 (Felder: id, name, parent_id, date)
- all_series.csv.bz2 (Felder: id, name, parent_id, date)
- all_seasons.csv.bz2 (Felder: id, name, parent_id, date)
- all_episodes.csv.bz2 (Felder: id, name, parent_id, date, series_id)
- all_games.csv.bz2 (Felder: id, name, parent_id, date)
- all_movieseries.csv.bz2 (Felder: id, name, parent_id, date)
- all_people.csv.bz2 (Felder: id, name, birthday, deathday, gender)
- all_people_aliases.csv.bz2 (Felder: person_id, name)
- people_links.csv.bz2 (Felder: source, key, people_id, language_iso_639_1)
- all_casts.csv.bz2 (Felder: movie_id, person_id, job_id, role, position)
- job_names.csv.bz2 (Felder: job_id, name, language_iso_639_1)
- all_characters.csv.bz2 (Felder: id, name)
- movie_categories.csv.bz2 (Felder: movie_id, category_id)
- movie_keywords.csv.bz2 (Felder: movie_id, category_id)
- category_names.csv.bz2 (Felder: category_id, name, language_iso_639_1)
- all_categories.csv.bz2 (Felder: id, parent_id, root_id)
- trailers.csv.bz2 (Felder: trailer_id, key, movie_id, language_iso_639_1, source) – Trailer (Youtube, Vimeo)
- movie_links.csv.bz2 (Felder: source, key, movie_id, language_iso_639_1)
- image_ids.csv.bz2 (Felder: image_id, object_id, object_type, image_version)
- image_licenses.csv.bz2 (Felder: image_id, source, license_id, author)
all_movie_aliases.csv.bz2 (Felder: movie_id, name, language_id, official_translation)(deprecated)- all_movie_aliases_iso.csv.bz2 (Felder: movie_id, name, language_iso_639_1, official_translation)
- all_votes.csv.bz2 (Felder: movie_id, vote_average, votes_count)
- movie_languages.csv.bz2 (Felder: movie_id, language_iso_639_1)
- movie_countries.csv.bz2 (Felder: movie_id, country_code)
- movie_details.csv.bz2 (Felder: movie_id, runtime, budget, revenue, homepage)
- movie_references.csv.bz2 (Felder: movie_id, referenced_id, type)
- movie_abstracts_de.csv.bz2 – nur deutsche Kurzbeschreibungen – (Felder: movie_id, abstract) – Bitte auch insbesondere hier die Lizenzbedingungen beachten!
- movie_abstracts_en.csv.bz2 – nur englische Kurzbeschreibungen – (Felder: movie_id, abstract)
- movie_abstracts_fr.csv.bz2 – nur französische Kurzbeschreibungen – (Felder: movie_id, abstract)
- movie_abstracts_es.csv.bz2 – nur spanische Kurzbeschreibungen – (Felder: movie_id, abstract)
- movie_content_updates.csv.bz2 (Felder: movie_id, last_update)
Die letzte Datei, “movie_content_updates.csv”, gibt an, wann eine Beschreibung eines Films, ob kurz oder lang, in welcher Sprache auch immer, zum letzten Mal geändert wurde. Hat man also die Beschreibung eines Films schon heruntergeladen, ist es auf jeden Fall sinnlos, sie nochmal herunterzuladen wenn sich das entsprechende Datum nicht geändert hat. Filme, deren Ids in dieser Liste fehlen, haben gar keine Beschreibung. (Umgekehrt sind aber auch Ids von Filmen in der Liste, die gelöscht wurden)
Um Daten eines bestimmten Films im XML-Format zu erhalten, muss an die Url ”/embed_data” gehängt werden, also https://www.omdb.org/movie/[movie_id]/embed_data
Es ist empfehlenswert, von omdb geladene Daten zu cachen und nicht ständig neu herunterzuladen. In weit über 90% der Filme ändern sich die Daten über Monate nicht. Bei den obigen Dateien lässt sich am Zeitstempel überprüfen, ob sich die Datei geändert hat und ein neuer Download nötig ist. Wenn durch zu häufige oder zu aggressive Downloads der Server zu stark belastet wird, müssen wir unter Umständen Gegenmaßnahmen ergreifen.
Die Formatierungen sind noch nicht dauerhaft festgelegt, können sich daher noch ändern.
omdb auf deiner Homepage
omdb-Informationen zu Filmen lassen sich auch auf der eigenen Homepage einbinden, siehe dazu Filminformationen einbinden.