omdb is provided under a free license. Thus it is possible to use the data following the license conditions.
At the moment there is no API for omdb but the following data is available in CSV format. The files each contain parts of the database and are updated several times a day, but only if the contained data has changed. The term “movies” does include series and episodes (with exeption of the file “all_movies.csv”).- all_movies.csv.bz2 (fields: id, name, parent_id, date)
- all_series.csv.bz2 (fields: id, name, parent_id, date)
- all_seasons.csv.bz2 (fields: id, name, parent_id, date)
- all_episodes.csv.bz2 (fields: id, name, parent_id, date, series_id)
- all_movieseries.csv.bz2 (fields: id, name, parent_id, date)
- all_people.csv.bz2 (fields: id, name, birthday, deathday, gender)
- all_people_aliases.csv.bz2 (fields: person_id, name)
- people_links.csv.bz2 (fields: source, key, people_id, language_iso_639_1)
- all_casts.csv.bz2 (fields: movie_id, person_id, job_id, role, position)
- job_names.csv.bz2 (fields: job_id, name, language_iso_639_1)
- all_characters.csv.bz2 (fields: id, name)
- movie_categories.csv.bz2 (fields: movie_id, category_id)
- movie_keywords.csv.bz2 (fields: movie_id, category_id)
- category_names.csv.bz2 (fields: category_id, name, language_iso_639_1)
- all_categories.csv.bz2 (fields: id, parent_id, root_id)
- trailers.csv.bz2 (fields: trailer_id, key, movie_id, language_iso_639_1, source) – Trailer (Youtube, Vimeo)
- movie_links.csv.bz2 (fields: source, key, movie_id, language_iso_639_1)
- image_ids.csv.bz2 (fields: image_id, object_id, object_type, image_version)
- image_licenses.csv.bz2 (fields: image_id, source, license_id, author)
all_movie_aliases.csv.bz2 (fields: movie_id, name, language_id, official_translation)(deprecated)- all_movie_aliases_iso.csv.bz2 (fields: movie_id, name, language_iso_639_1, official_translation)
- all_votes.csv.bz2 (fields: movie_id, vote_average, votes_count)
- movie_languages.csv.bz2 (fields: movie_id, language_iso_639_1)
- movie_countries.csv.bz2 (fields: movie_id, country_code)
- movie_details.csv.bz2 (fields: movie_id, runtime, budget, revenue, homepage)
- movie_references.csv.bz2 (fields: movie_id, referenced_id, type)
- movie_abstracts_de.csv.bz2 – only German abstracts – (fields: movie_id, abstract) – mind the license restrictions!
- movie_abstracts_en.csv.bz2 – only English abstracts – (fields: movie_id, abstract) – mind the license restrictions!
- movie_abstracts_fr.csv.bz2 – only French abstracts – (fields: movie_id, abstract)
- movie_abstracts_es.csv.bz2 – only Spanish abstracts – (fields: movie_id, abstract)
- movie_content_updates.csv.bz2 (fields: movie_id, last_update)
The last file, “movie_content_updates.csv”, indicates when a description or an abstract for a movie has been changed the last time in whatever language. So there is no use to download a description for a movie again, if this date has not changed. Movies whose id is not present in this file don’t have a description.
To get the data of a specific movie in Xml format you have to add ”/embed_data” to the url: http://www.omdb.org/movie/[movie_id]/embed_data
It is recommended to cache the downloaded data since most of the data doesn’t change for months. For the above files you can check the timestamp to see if a new download is necessary.
omdb on your homepage
omdb information on movies can also be embedded into your homepage, see embed movie information.