# Data sources

> amodb compiles movie and TV metadata from several upstream datasets and keeps TMDB v3 ids, so records match TMDB and IMDb ids one to one. Responses are cached at the edge for 10 minutes to 24 hours. Posters, backdrops and third party scores belong to their owners. Report a wrong value to support@amodb.dev.

## What the data covers

- Movies, TV shows, seasons, episodes, people, companies, networks, collections, genres and keywords, in the TMDB v3 shapes.
- Translations in 14 languages for titles, overviews, names and taglines where a translation exists.
- External ids: `imdb_id`, `tvdb_id`, `wikidata_id` and `kinopoisk_id`, used by `/3/find/{external_id}`.
- amodb extensions: moods, soundtracks, ratings, structured facts and cinema showtimes.

## Ids

Every record keeps its TMDB v3 id. A movie that is `550` in a TMDB client is `550` in amodb, and `imdb_id` matches the IMDb title id. This is why a client can switch base URLs without remapping its database.

## Freshness

| 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    |

A change in the source reaches you after the cache time of that path at most.

## Images

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.

## Scores

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`. The scores belong to the services that publish them. Show the name of the source next to a score.

## Report an error

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.

## Related pages

- [Images](https://amodb.dev/images/): Load posters, backdrops and profile photos from img.amodb.dev with TMDB paths and sizes from w92 to original. No key, 30 day cache, one URL pattern for all.
- [Contact](https://amodb.dev/contact/): Write to support@amodb.dev for help with keys, billing, errors or data corrections. What to include so we can answer in one reply, and who runs amodb.
- [Terms of service](https://amodb.dev/terms/): The amodb terms in plain language: accounts, keys, prepaid plans, payments, acceptable use, data and images, availability, liability and the law that applies.
- [About amodb](https://amodb.dev/about/): amodb is a small, paid movie and TV metadata API with TMDB v3 and OMDb compatible endpoints in 14 languages. Who runs it, how it works and what it promises.

Updated: 2026-10-18. Source: https://amodb.dev/data-sources/