Details - TMDB API Documentation

Details

curl --request GET \
  --url https://api.themoviedb.org/3/tv/{series_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/tv/{series_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/tv/{series_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/tv/{series_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/tv/{series_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "adult": false,
  "backdrop_path": "/bvzLXSB3HtV8h1fo1ROjSr7l8su.jpg",
  "created_by": [
    {
      "credit_id": "52533b8d19c295794006e2a3",
      "gender": 2,
      "id": 57293,
      "name": "Sydney Newman",
      "original_name": "Sydney Newman",
      "profile_path": "/QKW3Widw7yaemYlB3NKEmJrhrF.jpg"
    }
  ],
  "episode_run_time": [
    50,
    60
  ],
  "first_air_date": "1966-06-23",
  "genres": [
    {
      "id": 18,
      "name": "Drama"
    },
    {
      "id": 35,
      "name": "Comedy"
    },
    {
      "id": 10759,
      "name": "Action & Adventure"
    },
    {
      "id": 10765,
      "name": "Sci-Fi & Fantasy"
    }
  ],
  "homepage": "",
  "id": 122,
  "in_production": false,
  "languages": [
    "en"
  ],
  "last_air_date": "1967-03-25",
  "last_episode_to_air": {
    "air_date": "1967-03-25",
    "episode_number": 13,
    "episode_type": "finale",
    "id": 5685,
    "name": "A Sinister Sort of Service",
    "overview": "Is The Face behind a series of robberies?",
    "production_code": "",
    "runtime": null,
    "season_number": 2,
    "show_id": 122,
    "still_path": null,
    "vote_average": 0,
    "vote_count": 0
  },
  "name": "Adam Adamant Lives!",
  "networks": [
    {
      "id": 4,
      "logo_path": "/uJjcCg3O4DMEjM0xtno9OWFciRP.png",
      "name": "BBC One",
      "origin_country": "GB"
    }
  ],
  "next_episode_to_air": null,
  "number_of_episodes": 29,
  "number_of_seasons": 2,
  "origin_country": [
    "GB"
  ],
  "original_language": "en",
  "original_name": "Adam Adamant Lives!",
  "overview": "Adam Adamant Lives! is a British television series which ran from 1966 to 1967 on the BBC, starring Gerald Harper in the title role. Proposing that an adventurer born in 1867 had been revived from hibernation in 1966, the show was a comedy adventure that took a satirical look at life in the 1960s through the eyes of an Edwardian.",
  "popularity": 6.411,
  "poster_path": "/m1hkyeMvgPFKi2YnvU4ZFORaTd3.jpg",
  "production_companies": [],
  "production_countries": [],
  "seasons": [
    {
      "air_date": null,
      "episode_count": 5,
      "id": 357,
      "name": "Specials",
      "overview": "",
      "poster_path": null,
      "season_number": 0,
      "vote_average": 0
    },
    {
      "air_date": "1966-06-23",
      "episode_count": 16,
      "id": 355,
      "name": "Season 1",
      "overview": "",
      "poster_path": null,
      "season_number": 1,
      "vote_average": 10
    },
    {
      "air_date": "1966-12-31",
      "episode_count": 13,
      "id": 356,
      "name": "Season 2",
      "overview": "",
      "poster_path": null,
      "season_number": 2,
      "vote_average": 0
    }
  ],
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    }
  ],
  "status": "Ended",
  "tagline": "",
  "type": "Scripted",
  "vote_average": 7.5,
  "vote_count": 4
}

GET

{series_id}

Details

curl --request GET \
  --url https://api.themoviedb.org/3/tv/{series_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.themoviedb.org/3/tv/{series_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.themoviedb.org/3/tv/{series_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.themoviedb.org/3/tv/{series_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.themoviedb.org/3/tv/{series_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "adult": false,
  "backdrop_path": "/bvzLXSB3HtV8h1fo1ROjSr7l8su.jpg",
  "created_by": [
    {
      "credit_id": "52533b8d19c295794006e2a3",
      "gender": 2,
      "id": 57293,
      "name": "Sydney Newman",
      "original_name": "Sydney Newman",
      "profile_path": "/QKW3Widw7yaemYlB3NKEmJrhrF.jpg"
    }
  ],
  "episode_run_time": [
    50,
    60
  ],
  "first_air_date": "1966-06-23",
  "genres": [
    {
      "id": 18,
      "name": "Drama"
    },
    {
      "id": 35,
      "name": "Comedy"
    },
    {
      "id": 10759,
      "name": "Action & Adventure"
    },
    {
      "id": 10765,
      "name": "Sci-Fi & Fantasy"
    }
  ],
  "homepage": "",
  "id": 122,
  "in_production": false,
  "languages": [
    "en"
  ],
  "last_air_date": "1967-03-25",
  "last_episode_to_air": {
    "air_date": "1967-03-25",
    "episode_number": 13,
    "episode_type": "finale",
    "id": 5685,
    "name": "A Sinister Sort of Service",
    "overview": "Is The Face behind a series of robberies?",
    "production_code": "",
    "runtime": null,
    "season_number": 2,
    "show_id": 122,
    "still_path": null,
    "vote_average": 0,
    "vote_count": 0
  },
  "name": "Adam Adamant Lives!",
  "networks": [
    {
      "id": 4,
      "logo_path": "/uJjcCg3O4DMEjM0xtno9OWFciRP.png",
      "name": "BBC One",
      "origin_country": "GB"
    }
  ],
  "next_episode_to_air": null,
  "number_of_episodes": 29,
  "number_of_seasons": 2,
  "origin_country": [
    "GB"
  ],
  "original_language": "en",
  "original_name": "Adam Adamant Lives!",
  "overview": "Adam Adamant Lives! is a British television series which ran from 1966 to 1967 on the BBC, starring Gerald Harper in the title role. Proposing that an adventurer born in 1867 had been revived from hibernation in 1966, the show was a comedy adventure that took a satirical look at life in the 1960s through the eyes of an Edwardian.",
  "popularity": 6.411,
  "poster_path": "/m1hkyeMvgPFKi2YnvU4ZFORaTd3.jpg",
  "production_companies": [],
  "production_countries": [],
  "seasons": [
    {
      "air_date": null,
      "episode_count": 5,
      "id": 357,
      "name": "Specials",
      "overview": "",
      "poster_path": null,
      "season_number": 0,
      "vote_average": 0
    },
    {
      "air_date": "1966-06-23",
      "episode_count": 16,
      "id": 355,
      "name": "Season 1",
      "overview": "",
      "poster_path": null,
      "season_number": 1,
      "vote_average": 10
    },
    {
      "air_date": "1966-12-31",
      "episode_count": 13,
      "id": 356,
      "name": "Season 2",
      "overview": "",
      "poster_path": null,
      "season_number": 2,
      "vote_average": 0
    }
  ],
  "spoken_languages": [
    {
      "english_name": "English",
      "iso_639_1": "en",
      "name": "English"
    }
  ],
  "status": "Ended",
  "tagline": "",
  "type": "Scripted",
  "vote_average": 7.5,
  "vote_count": 4
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

series_id

integer

required

a uniques identifier for a tv serie

Query Parameters

append_to_response

string

Example:

"videos"

language

string

default:en-US

Response

200 - application/json

Details

adult

boolean

Example:

false

backdrop_path

string

Example:

"/bvzLXSB3HtV8h1fo1ROjSr7l8su.jpg"

created_by

object[]

Show child attributes

Example:

[
  {
    "credit_id": "52533b8d19c295794006e2a3",
    "gender": 2,
    "id": 57293,
    "name": "Sydney Newman",
    "original_name": "Sydney Newman",
    "profile_path": "/QKW3Widw7yaemYlB3NKEmJrhrF.jpg"
  }
]

episode_run_time

number[]

Example:

[50, 60]

first_air_date

string

Example:

"1966-06-23"

genres

object[]

Show child attributes

Example:

[
  { "id": 18, "name": "Drama" },
  { "id": 35, "name": "Comedy" },
  { "id": 10759, "name": "Action & Adventure" },
  { "id": 10765, "name": "Sci-Fi & Fantasy" }
]

homepage

string

Example:

""

number

Example:

122

in_production

boolean

Example:

false

languages

string[]

Example:

["en"]

last_air_date

string

Example:

"1967-03-25"

last_episode_to_air

object

Show child attributes

name

string

Example:

"Adam Adamant Lives!"

networks

object[]

Show child attributes

Example:

[
  {
    "id": 4,
    "logo_path": "/uJjcCg3O4DMEjM0xtno9OWFciRP.png",
    "name": "BBC One",
    "origin_country": "GB"
  }
]

next_episode_to_air

unknown

number_of_episodes

number

Example:

29

number_of_seasons

number

Example:

2

origin_country

string[]

Example:

["GB"]

original_language

string

Example:

"en"

original_name

string

Example:

"Adam Adamant Lives!"

overview

string

Example:

"Adam Adamant Lives! is a British television series which ran from 1966 to 1967 on the BBC, starring Gerald Harper in the title role. Proposing that an adventurer born in 1867 had been revived from hibernation in 1966, the show was a comedy adventure that took a satirical look at life in the 1960s through the eyes of an Edwardian."

popularity

number

Example:

6.411

poster_path

string

Example:

"/m1hkyeMvgPFKi2YnvU4ZFORaTd3.jpg"

production_companies

any[]

Example:

[]

production_countries

any[]

Example:

[]

seasons

object[]

Show child attributes

Example:

[
  {
    "air_date": null,
    "episode_count": 5,
    "id": 357,
    "name": "Specials",
    "overview": "",
    "poster_path": null,
    "season_number": 0,
    "vote_average": 0
  },
  {
    "air_date": "1966-06-23",
    "episode_count": 16,
    "id": 355,
    "name": "Season 1",
    "overview": "",
    "poster_path": null,
    "season_number": 1,
    "vote_average": 10
  },
  {
    "air_date": "1966-12-31",
    "episode_count": 13,
    "id": 356,
    "name": "Season 2",
    "overview": "",
    "poster_path": null,
    "season_number": 2,
    "vote_average": 0
  }
]

spoken_languages

object[]

Show child attributes

Example:

[
  {
    "english_name": "English",
    "iso_639_1": "en",
    "name": "English"
  }
]

status

string

Example:

"Ended"

tagline

string

Example:

""

type

string

Example:

"Scripted"

vote_average

number

Example:

7.5

vote_count

number

Example:

4