amodb returns the TMDB v3 record shapes for movies, TV shows and people, plus five extensions. Every record keeps its TMDB v3 id, text comes in 14 languages, and replies are cached at the edge for 10 minutes to 24 hours, with images cached for 30 days. Fields without a value come back empty or as null.
What does movie metadata coverage include?
amodb does not name the sources behind its records. This page lists what each endpoint returns and how fresh it is.
| Area | What it holds | Reference |
|---|---|---|
| Movies | Titles, overviews, taglines, release dates, runtimes, genres, imdb_id, cast and crew | movie details API |
| TV shows | Series details, networks, seasons and episodes | TMDB TV API and seasons and episodes API |
| People | Biographies, birthdays, filmographies | person API |
| Companies, collections, genres, keywords | Production companies, networks, franchises, genre ids, keyword ids | production companies and networks and collections API |
| Videos and images | Trailer links and image paths in 10 sizes | TMDB trailer API and TMDB image sizes |
| Translations | Titles, overviews, names and taglines in 14 languages where a translation exists | translations API |
| External ids | imdb_id, tvdb_id, wikidata_id and kinopoisk_id, 12 sources in all | search by IMDb id |
| Ratings | IMDb, Kinopoisk, Metacritic, Rotten Tomatoes and TMDB scores in one object | movie ratings API |
| Moods, soundtracks, facts, showtimes | Nine moods, albums and tracks, budget and box office, cinema screenings | movie mood API and cinema showtimes API |
For a wider view of the product, see the movie database API page.
Which fields can be empty or null?
| Field | When it is empty |
|---|---|
ratings.imdb, kinopoisk, metacritic, rotten_tomatoes, tmdb | Each key is null when no score exists, and its vote count can be null too. Do not rely on any single score being present |
moods | source is null and results is empty for a title without mood data |
soundtracks | results can be empty, and artist, released and url can be null |
wikidata | Money fields such as budget and box_office are null when unknown |
showtimes | Without a country parameter results is empty and only the countries summary is filled |
reviews, alternative_titles, TV created_by | Filled only for some titles |
| Translated text | Falls back to English outside the 14 languages |
Some TMDB paths are not offered: aggregate_credits, the changes endpoints and person/ answer HTTP 404 with status_code 34.
Which languages does the movie metadata cover?
Fourteen base languages are served: en, ru, uk, be, zh, pt, bg, he, cs, ro, fr, pl, it and es. TMDB tags such as pt-BR and ru-RU are accepted. Any other language falls back to English. The language codes page has the full table.
How do ids match TMDB and IMDb?
Every record keeps its TMDB v3 id. A movie that is 550 in a TMDB client is 550 in amodb, and imdb_id holds the IMDb title id where one exists. This is why a client can switch base URLs without remapping its database. To go the other way, send an external id to /3/find/{external_id}.
How fresh is the movie metadata?
| Data | Edge cache |
|---|---|
| Configuration | 24 hours |
| Details and credits | 6 hours |
| Trending, popular, now playing, on the air, discover | 30 minutes |
| Search | 10 minutes |
| Images | 30 days |
These times are the most the edge cache adds to the age of a reply. A record that has not changed can be older than that. The cache is shared across keys, the key check and the rate limit run before the cache lookup, and cached replies still count toward your rate. See rate limits for the per minute numbers.
Who owns the images and scores?
Posters, backdrops, logos and photos belong to studios, distributors and other rights holders. amodb hosts them so your app can show them next to the matching record. You are responsible for how you use them in your product.
The ratings extension returns scores published by other services under the keys imdb, kinopoisk, metacritic, rotten_tomatoes and tmdb, each with a value and a vote count or null. IMDb, Kinopoisk and TMDB scores are out of 10, Metacritic and Rotten Tomatoes out of 100. The scores belong to the services that publish them. Show the name of the source next to a score. amodb itself requires no amodb logo, badge or credit line. Third party content keeps its own credit: credit JustWatch when you show where to watch data, and show the author, license and source link from the attribution object wherever a text or image carries one. The terms cover the details.
How do I report a wrong value?
Write to support@amodb.dev with the endpoint, the id, the field, the wrong value and the correct value with a public source. We review every report. A confirmed fix reaches the API after the cache time of that path. The amodb support page lists what else to include.