How to Use TMDB IDs with Video Players

Learn how TMDB movie and TV identifiers map to embeddable video player URLs, metadata requests, and developer integrations.

Developer intent

Use a TMDB ID as the stable content key in your app, then pass it to an embed URL or player SDK.

What is a TMDB ID?

A TMDB ID is a numeric identifier from The Movie Database. Developers use it to reference movies and TV shows without storing titles, release dates, or localized names as primary keys.

Movie embed example

For a movie, place the TMDB ID directly after /embed/movie/. The player resolves metadata, available streams, subtitles, and server fallback behavior.

TV episode example

For a TV show, combine the show TMDB ID with season and episode numbers so the player knows the exact episode to load.

Example

fetch('/api/tmdb?id=27205&type=movie')

<iframe src="https://www.vidcore.org/embed/movie/27205" allowFullScreen />