Quickstart

Learn how to get your API Key and Session ID

Set Up Your API Key and Bearer Token

Follow these quick steps to obtain your API Key:

1. Registration

Please note: The API registration process is not optimized for mobile devices. Use a desktop computer and browser for the best experience. Before receiving your API key, you’ll need to agree to our terms of use. You can read them here.

Join

1. Go to TheMovieDB

2. Click on Join TDB

   
3. Fill in your details (Username, password and email address)
4. Activate your Account

   TMDB will send you a mail to confirm your address. Click on ACTIVATE MY ACCOUNT

5. Enter your email and password

   Once your email is verified, re-enter the username and password you used for registration.

Didn’t receive a confirmation email?

If you didn’t get an email, you can request a resend.

If you try again and still don’t receive a confirmation email, your email address might be incorrect. Please restart the registration process and ensure you enter the correct email address.

2. Generate Your API Key

Get your API Key

1. Once logged in, click on your profile icon (the icon with the first letter of your username).

2. Click on Settings

3. On the sidebar, scroll down and click on API

   
4. Under Request an API Key, click on click here to generate an API key.

   
5. Choose the type of API key you want to register for and accept the terms of use.

6. Fill in your application details and click on Submit.

7. After a successful submission, you’ll be redirected to another page. Scroll down to find your API Read Access Token and API Key.

   

   Do not share these details with anyone.

You can always copy your API Key from your account settings page.

---

How to create session id?

Please check out versioning and session ID to have a better undestanding

Creating a Session ID(Version 3)

How do I generate a session ID?

1. Request Token

   First, request a new token.

   curl --request GET \  
     --url https://api.themoviedb.org/3/authentication/token/new \  
     --header 'Authorization: Bearer {ACCESS_TOKEN}' \  
     --header 'accept: application/json'
   

   This temporary token allows you to ask the user for permission to access their account.

2. Ask the user for permission

   With a request token in hand, approve it using this URL:

   https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}
   

   Or, use this URL with a redirect_to parameter:

   https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved
   

   Once approved, the user will be redirected to your specified URL or to the /authenticate/allow path on TMDB. If they aren’t redirected, the page will include an Authentication-Callback header, containing the API call for the next step.

3. Create a session ID

   By calling the new session method with the approved request token from step 2, you’ll receive a new session_id.

---

Creating Session ID(Version 4)

How do I generate a session ID?

1. Request a request token with your access token.

2. Authorize it using this URL:

    https://www.themoviedb.org/auth/access?request_token={REQUEST_TOKEN}
   
3. Generate an access token with your request token.