.api-key{
    background-color: #01b4e4;
    width: 400px;
    height: 40px;
    border-radius: 15px;
    margin: 0 0 0 10px;
}

// Create a popup function with sliding messages
function showPopupMessage(mainMessage, secondaryMessage) {
  // Create the overlay for the blur effect
  const overlay = document.createElement('div');
  overlay.style.position = 'fixed';
  overlay.style.top = '0';
  overlay.style.left = '0';
  overlay.style.width = '100%';
  overlay.style.height = '100%';
  overlay.style.backgroundColor = 'rgba(0, 0, 0, 0.6)'; // Darker semi-transparent background
  overlay.style.backdropFilter = 'blur(8px)';
  overlay.style.zIndex = '999';

  // Create the popup container
  const popup = document.createElement('div');
  popup.style.position = 'fixed';
  popup.style.left = '50%';
  popup.style.top = '50%';
  popup.style.transform = 'translate(-50%, -50%)';
  popup.style.width = '80%';
  popup.style.maxWidth = '400px';
  popup.style.padding = '20px';
  popup.style.backgroundColor = '#0d253f';
  popup.style.borderRadius = '12px';
  popup.style.boxShadow = '0 4px 8px rgba(0, 0, 0, 0.1)';
  popup.style.zIndex = '1000';
  popup.style.fontFamily = 'Arial, sans-serif';
  popup.style.textAlign = 'center';
  popup.style.color = 'white';
  popup.style.overflow = 'hidden';

  // Create the main message slide
  const mainMessageSlide = document.createElement('div');
  mainMessageSlide.innerText = mainMessage;
  mainMessageSlide.style.fontSize = '20px';
  mainMessageSlide.style.padding = '20px';

  // Create the secondary message slide
  const secondaryMessageSlide = document.createElement('div');
  secondaryMessageSlide.innerText = secondaryMessage;
  secondaryMessageSlide.style.fontSize = '16px';
  secondaryMessageSlide.style.padding = '20px';
  secondaryMessageSlide.style.display = 'none';
  // Create navigation button (arrow icon)
  const nextButton = document.createElement('button');
  nextButton.innerHTML = '&#10132;'; // Right arrow icon
  nextButton.style.marginTop = '20px';
  nextButton.style.padding = '10px 20px';
  nextButton.style.border = 'none';
  nextButton.style.borderRadius = '5px';
  nextButton.style.backgroundColor = '#01b4e4';
  nextButton.style.color = 'white';
  nextButton.style.cursor = 'pointer';
  nextButton.style.fontSize = '16px';

  // Create the close button
  const closeButton = document.createElement('button');
  closeButton.innerText = 'Close';
  closeButton.style.marginTop = '20px';
  closeButton.style.padding = '10px 20px';
  closeButton.style.border = 'none';
  closeButton.style.borderRadius = '5px';
  closeButton.style.backgroundColor = '#FF4B4B';
  closeButton.style.color = 'white';
  closeButton.style.cursor = 'pointer';
  closeButton.style.fontSize = '16px';
  closeButton.style.display = 'none';

  // Slide to secondary message
  nextButton.onclick = function () {
    mainMessageSlide.style.display = 'none';
    secondaryMessageSlide.style.display = 'block';
    nextButton.style.display = 'none';
    closeButton.style.display = 'inline-block';
  };

  // Close popup and overlay on button click
  closeButton.onclick = function () {
    popup.remove();
    overlay.remove();
  };

  popup.appendChild(mainMessageSlide);
  popup.appendChild(secondaryMessageSlide);
  popup.appendChild(nextButton);
  popup.appendChild(closeButton);

  document.body.appendChild(overlay);
  document.body.appendChild(popup);
}

// Check if the popup has already been shown in this session
if (!sessionStorage.getItem('popupShown')) {
    // Example usage
    showPopupMessage(
      'Welcome to TMDB API Documentation!',
      '⚠️ This documentation uses the TMDB API but is not endorsed or certified by TMDB.'
    );
  
    // Set the flag to indicate the popup has been shown
    sessionStorage.setItem('popupShown', 'true');
  }
  

2023

2022

Changelog

TMDB API Documentation

Overview

Learn how to get your API Key and Session ID

Quickstart

Application

Wrappers and Libraries

This is a list of status codes used by TMDB.

Status Codes

Rate Limiting

Roadmap

Append To Response

Image URL

Daily ID Exports

Finding Data

Guest Session

How do languages work with image queries?

Include Image Language

Languages

Popularity and Trending

Regions

Learn how to search and query for a movie.

Search & Query

Search & Query For Details

User Authentication

This is an interactive playground to test your API key

Introduction

Authentication

Account ID

This endpoint get the public details of user's account.

Details

This endpoint allows the user to add a specific media item as a favorite.

Add Favourite

This endpoint allows the user to add a movie or TV show to their watchlist.

Add to Watchlist

This endpoint get user's list of favorite movies.

Favorite Movies

This endpoint get user's list of favorite tv shows.

Favorite TV

This endpoint get the lists of user's added movies

Lists

This endpoint get list of user's rated movies

Rated Movie

This endpoint get list of user's rated TV

Rated Tv

This endpoint get the list of user's list of rated tv episodes

Rated Tv Episode

This endpoint get a list of movies added to a users watchlist.

Watchlist Movies

This endpoint get a list of TV shows added to a users watchlist.

Watchlist TV

This endpoint create a new guest session.

Create Guest Session

This endpoint obtain a new token from the authentication server.

Create Request Token

This endpoint allow users to validate a request token by entering a username and password.

Validate Request Token with login

This endpoint is used to create a new session.

Create Session

This endpoint is used to create  v4 session ID with v4 access token.

Create Session (from v4 token)

This endpoint is used to delete a session id.

Delete Session

This endpoint test your API Key to see if it's valid.

Validate Key

This endpoint get the list of movie certifications for different countries.

Movies

This endpoint get the list of TV show certifications for different countries.

This endpoint get a list of all of the movie ids that have been changed in the past 24 hours.

Movies List

This endpoint get list of all of the people ids that have been changed in the past 24 hours.

People List

This endpoint get list of all of the tv show ids that have been changed in the past 24 hours.

TV List

This endpoint get movies collection details by ID.

This endpoints get images that belong to a collection.

Images

This endpoint get the translations for a specific collection.

Translations

This endpoint get details of a specific company

This endpoint get company's alternative names

Alternative Names

This endpoint get the API configuration details.

This endpoint get the list of the jobs and departments we use on TMDB.

This endpoint get the list of countries (ISO 3166-1 tags) used throughout TMDB.

Countries

This endpoint retrieves the list of languages (ISO 639-1 tags) used throughout TMDB.

This endpoint get list of the officially supported translations on TMDB.

Primary Translation

This endpoint get the list of timezones used throughout TMDB..

Time Zones

This endpoint get a movie or TV credit details.

This endpoint find movies using 30 filters and sort options.

The endpoint find TV shows using over 30 filters and sort options.

This endpoint find data by external ID's.

Find by ID

This endpoint get the list of official genres for movies

This endpoint get the list of official genres for TV shows

This endpoint get rated movies for a guest session.

This endpoint get rated TV shows for a guest session.

Rated TV

This endpoint get rated TV episodes for a guest session.

Rated TV Episodes

This endpoint get information about a specific keyword

The endpoint get a list of movies associated with a keyword

This endpoint get details of a specific list

Delete

This endpoint is used to add a movie to a list

Add Movie

This endpoint check if an item has already been added to the list.

Check item Status

This endpoint clear all items from a list.

Clear

This endpoint is used add of movie detail to list.

Create

This endpoint is used to remove a movie from a list.

Remove Movie

This endpoint get the list of movies that are currently in theatres in a country.

Now Playing

This endpoint get the list of popular movies.

Top Rated

This endpoint get upcoming movies with a specific language, page, and region.

Upcoming

This endpoint get the top level details of a movie by ID.

This endpoint get the rating, watchlist and favourite status of an account.

Account States

This endpoint get alternative titles for a Movie

Alternative Title

This endpoint get recent changes for a movie

Changes

This endpoint get the credits for a specific movie.

Credit

The endpoint get the external IDs associated with a specific movie.

External IDs

The endpoint get images associated with a specific movie.

This endpoint get keywords associated with a specific movie

Keywords

This endpoint get the details of the latest movie.

Latest

This endpoint get the lists that a movie has been added to.

This endpoint get a list of recommended movies for a specific movie, identified by its unique ID.

Recommendations

This endpoint get the release date and certification of a movie.

Release Dates

Reviews

This endpoint get the similar movies based on genres and keywords.

Similar

This enpoint get the translations for a movie.

Videos

This endpoint get the list of streaming providers for a movie.

Watch Providers

This endpoint allow users to rate a movie and save it to their rated list.

Add Rating

Delete Rating

This endpoint get details for a specific network based on the provided network ID.

This endpoint get the alternative names of a specifc network.

Alternative names

This endpoint get the details of a person

This endpoint get the recent changes for a person

This endpoint get the combined movie and TV credits that belong to a person.

Combine Credit

This endpoint get the external ID's that belong to a person.

This endpoint get the profile images that belong to a person.

This endpoint get the latest person in the industry. This is a live response and will continuously change.

This endpoint get the movie credits of a person

Movie Credit

This endpoint get the TV show credits that belong to a person.

TV Credit

This endpoint get the tagged images for a person.

Tagged Images

This endpoint get the translations that belong to a person.

This endpoint get list of popular people.

This endpoint get the details of a movie or TV show review.

This endpoint search for collections by their original, translated and alternative names.

Collection

This endpoint search companies by their original and alternative names.

Company

This endpoint search for keywords by their name.

This endpoint serach for movies by their original, translated and alternative titles.

This endpoint multi search for movies, TV shows and people in a single request.

Multi

This endpoint search for people in a based on type of movies or tv shows.

Person

This endpoint search for TV shows by their original, translated and also known as names.

This endpoint get all trending movies, TV shows and people.

This endpoint get the list of trending movies.

Movie

This endpoint get the list of trending people.

People

This endpoint get list of TV shows airing today.

Airing Today

The endpoint get list of TV shows that air in the next 7 days.

On The Air

This endpoint get list of popular TV shows.

This endpoint get list of most rated TV show

Change Log

Changelog

Migration Complete

Migrating to ReadMe…

Welcome to The Movie Database (TMDB)