Changes - TMDB API Documentation

Changes

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

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

fetch('https://api.themoviedb.org/3/tv/{series_id}/season/changes', 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}/season/changes",
  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}/season/changes"

	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}/season/changes")

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

{
  "_id": "5256e7d719c2956ff60e3ad7",
  "air_date": null,
  "episodes": [
    {
      "air_date": null,
      "crew": [
        {
          "adult": false,
          "credit_id": "5256e7df19c2956ff60e3f17",
          "department": "Writing",
          "gender": 2,
          "id": 52139,
          "job": "Writer",
          "known_for_department": "Acting",
          "name": "Seth MacFarlane",
          "original_name": "Seth MacFarlane",
          "popularity": 23.499,
          "profile_path": "/8oQJqM51Z0Qtdb7sE6ZfX1peNCB.jpg"
        }
      ],
      "episode_number": 1,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65989,
      "name": "Original Pilot",
      "overview": "Francine puts Roger on a diet. After begin rejected by a girl, Steve notices that girls are affectionate to men with dogs, and wants to get a dog. Hayley agrees to provide Roger with Junk food when he offers to write her English papers for her. Stan rigs the school election so that Steve becomes the school president.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/91VfyG0e0IzX8AUtKjnZBak2tph.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2005-02-06",
      "crew": [],
      "episode_number": 2,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534611,
      "name": "Super Bowl Pre-Game Promo",
      "overview": "This one-and-a-half-minute short was aired before the game at Super Bowl XXXIX.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/g33ySYoVmGFc2P5VPCcoLsT6M7S.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 3,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65987,
      "name": "All in the Family - Creating American Dad!",
      "overview": "Describes How American Dad was created",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/u5oH9od6SfSOBqx9pVA9KwdFPFk.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 4,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65985,
      "name": "How's Your Aspen?: American Dad! Live at the 2005 U.S. Comedy Arts Festival",
      "overview": "Cast of American Dad at HBO's 2005 U.S. Comedy Arts Festival doing a live show.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/uTONw5DM0Q8zNIY52Ie4qiBLdvf.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 5,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65986,
      "name": "Secrets of the Glass Booth - Behind the Voices of American Dad!",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/mEqmJEP5H5ZnirTmlyTy9uEz5yv.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 6,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534609,
      "name": "American Animatics!",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/dBzy0MuIK7GiNfvESeB82QICiZR.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 7,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534610,
      "name": "Complete Animatics and Table Read for \"Threat Levels\"",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/d9W4dp8K6rxg9K4MiNkmekMUpQY.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2009-04-28",
      "crew": [],
      "episode_number": 8,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65984,
      "name": "Roger Master of Disguise",
      "overview": "Special as included on the Season 4 DVD.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2009-04-28",
      "crew": [],
      "episode_number": 9,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65983,
      "name": "Tearjerker And Then They Will Cry",
      "overview": "Special as included on the Season 4 DVD.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0
    }
  ],
  "id": 3816,
  "name": "Specials",
  "overview": "",
  "poster_path": "/7PkXhP5zoMSApTkyeg8Qkg3IEgu.jpg",
  "season_number": 0,
  "vote_average": 0
}

GET

{series_id}

season

changes

Changes

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

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

fetch('https://api.themoviedb.org/3/tv/{series_id}/season/changes', 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}/season/changes",
  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}/season/changes"

	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}/season/changes")

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

{
  "_id": "5256e7d719c2956ff60e3ad7",
  "air_date": null,
  "episodes": [
    {
      "air_date": null,
      "crew": [
        {
          "adult": false,
          "credit_id": "5256e7df19c2956ff60e3f17",
          "department": "Writing",
          "gender": 2,
          "id": 52139,
          "job": "Writer",
          "known_for_department": "Acting",
          "name": "Seth MacFarlane",
          "original_name": "Seth MacFarlane",
          "popularity": 23.499,
          "profile_path": "/8oQJqM51Z0Qtdb7sE6ZfX1peNCB.jpg"
        }
      ],
      "episode_number": 1,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65989,
      "name": "Original Pilot",
      "overview": "Francine puts Roger on a diet. After begin rejected by a girl, Steve notices that girls are affectionate to men with dogs, and wants to get a dog. Hayley agrees to provide Roger with Junk food when he offers to write her English papers for her. Stan rigs the school election so that Steve becomes the school president.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/91VfyG0e0IzX8AUtKjnZBak2tph.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2005-02-06",
      "crew": [],
      "episode_number": 2,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534611,
      "name": "Super Bowl Pre-Game Promo",
      "overview": "This one-and-a-half-minute short was aired before the game at Super Bowl XXXIX.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/g33ySYoVmGFc2P5VPCcoLsT6M7S.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 3,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65987,
      "name": "All in the Family - Creating American Dad!",
      "overview": "Describes How American Dad was created",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/u5oH9od6SfSOBqx9pVA9KwdFPFk.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 4,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65985,
      "name": "How's Your Aspen?: American Dad! Live at the 2005 U.S. Comedy Arts Festival",
      "overview": "Cast of American Dad at HBO's 2005 U.S. Comedy Arts Festival doing a live show.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/uTONw5DM0Q8zNIY52Ie4qiBLdvf.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 5,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65986,
      "name": "Secrets of the Glass Booth - Behind the Voices of American Dad!",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/mEqmJEP5H5ZnirTmlyTy9uEz5yv.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 6,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534609,
      "name": "American Animatics!",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/dBzy0MuIK7GiNfvESeB82QICiZR.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2006-04-25",
      "crew": [],
      "episode_number": 7,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 1534610,
      "name": "Complete Animatics and Table Read for \"Threat Levels\"",
      "overview": "",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": "/d9W4dp8K6rxg9K4MiNkmekMUpQY.jpg",
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2009-04-28",
      "crew": [],
      "episode_number": 8,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65984,
      "name": "Roger Master of Disguise",
      "overview": "Special as included on the Season 4 DVD.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0
    },
    {
      "air_date": "2009-04-28",
      "crew": [],
      "episode_number": 9,
      "episode_type": "standard",
      "guest_stars": [],
      "id": 65983,
      "name": "Tearjerker And Then They Will Cry",
      "overview": "Special as included on the Season 4 DVD.",
      "production_code": "",
      "runtime": 22,
      "season_number": 0,
      "show_id": 1433,
      "still_path": null,
      "vote_average": 0,
      "vote_count": 0
    }
  ],
  "id": 3816,
  "name": "Specials",
  "overview": "",
  "poster_path": "/7PkXhP5zoMSApTkyeg8Qkg3IEgu.jpg",
  "season_number": 0,
  "vote_average": 0
}

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

end_date

string

start_date

string

page

integer

default:1

Response

200 - application/json

Changes

_id

string

Example:

"5256e7d719c2956ff60e3ad7"

air_date

unknown

episodes

object[]

Show child attributes

Example:

[
  {
    "air_date": null,
    "crew": [
      {
        "adult": false,
        "credit_id": "5256e7df19c2956ff60e3f17",
        "department": "Writing",
        "gender": 2,
        "id": 52139,
        "job": "Writer",
        "known_for_department": "Acting",
        "name": "Seth MacFarlane",
        "original_name": "Seth MacFarlane",
        "popularity": 23.499,
        "profile_path": "/8oQJqM51Z0Qtdb7sE6ZfX1peNCB.jpg"
      }
    ],
    "episode_number": 1,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65989,
    "name": "Original Pilot",
    "overview": "Francine puts Roger on a diet. After begin rejected by a girl, Steve notices that girls are affectionate to men with dogs, and wants to get a dog. Hayley agrees to provide Roger with Junk food when he offers to write her English papers for her. Stan rigs the school election so that Steve becomes the school president.",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/91VfyG0e0IzX8AUtKjnZBak2tph.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2005-02-06",
    "crew": [],
    "episode_number": 2,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 1534611,
    "name": "Super Bowl Pre-Game Promo",
    "overview": "This one-and-a-half-minute short was aired before the game at Super Bowl XXXIX.",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/g33ySYoVmGFc2P5VPCcoLsT6M7S.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2006-04-25",
    "crew": [],
    "episode_number": 3,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65987,
    "name": "All in the Family - Creating American Dad!",
    "overview": "Describes How American Dad was created",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/u5oH9od6SfSOBqx9pVA9KwdFPFk.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2006-04-25",
    "crew": [],
    "episode_number": 4,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65985,
    "name": "How's Your Aspen?: American Dad! Live at the 2005 U.S. Comedy Arts Festival",
    "overview": "Cast of American Dad at HBO's 2005 U.S. Comedy Arts Festival doing a live show.",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/uTONw5DM0Q8zNIY52Ie4qiBLdvf.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2006-04-25",
    "crew": [],
    "episode_number": 5,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65986,
    "name": "Secrets of the Glass Booth - Behind the Voices of American Dad!",
    "overview": "",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/mEqmJEP5H5ZnirTmlyTy9uEz5yv.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2006-04-25",
    "crew": [],
    "episode_number": 6,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 1534609,
    "name": "American Animatics!",
    "overview": "",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/dBzy0MuIK7GiNfvESeB82QICiZR.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2006-04-25",
    "crew": [],
    "episode_number": 7,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 1534610,
    "name": "Complete Animatics and Table Read for \"Threat Levels\"",
    "overview": "",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": "/d9W4dp8K6rxg9K4MiNkmekMUpQY.jpg",
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2009-04-28",
    "crew": [],
    "episode_number": 8,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65984,
    "name": "Roger Master of Disguise",
    "overview": "Special as included on the Season 4 DVD.",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": null,
    "vote_average": 0,
    "vote_count": 0
  },
  {
    "air_date": "2009-04-28",
    "crew": [],
    "episode_number": 9,
    "episode_type": "standard",
    "guest_stars": [],
    "id": 65983,
    "name": "Tearjerker And Then They Will Cry",
    "overview": "Special as included on the Season 4 DVD.",
    "production_code": "",
    "runtime": 22,
    "season_number": 0,
    "show_id": 1433,
    "still_path": null,
    "vote_average": 0,
    "vote_count": 0
  }
]

number

Example:

3816

name

string

Example:

"Specials"

overview

string

Example:

""

poster_path

string

Example:

"/7PkXhP5zoMSApTkyeg8Qkg3IEgu.jpg"

season_number

number

Example:

0

vote_average

number

Example:

0