Rated TV Episodes

This endpoint get a users list of rated TV episodes.

Authorizations

Authorization

string

header

required

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

Path Parameters

account_id

integer

required

This refers to a unique identifier assigned to a user account.

Example:

""

Query Parameters

language

string

Specifies the language in which the response should be returned.

Example:

"en-US"

page

integer

Indicates which page of results to return. Default is the first page (1).

Example:

1

session_id

string

A token that represents a logged-in user's session after they have authenticated with their TMDB account.

Example:

""

sort_by

enum<string>

Determines how the results should be sorted. 'created_at.asc' indicates ascending order based on the creation date.

Available options:

created_at.asc,

created_at.desc

Example:

"created_at.asc"

Response

200 - application/json

rated tv episodes

page

number

Indicates the current page number of the results being returned.

Example:

1

results

object[]

This represents a collection of movie objects returned by the API that provides information about various films.

Show child attributes

results.air_date

string

The date when the episode originally aired, formatted as YYYY-MM-DD.

Example:

"2013-10-17"

results.episode_number

number

The specific episode number within its season.

Example:

5

results.id

number

A unique identifier for the episode.

Example:

64782

results.name

string

The title of the episode.

Example:

"The Workplace Proximity"

results.overview

string

A brief summary of the episode's plot.

Example:

"Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes."

results.production_code

string

A code used for identifying the episode during production; may be empty if not specified.

Example:

"4X5305"

results.rating

number

An integer that serves as a custom rating value that may reflect how the episode is perceived overall.

Example:

8

results.runtime

number

The duration of the episode in minutes.

Example:

22

results.season_number

number

The season number in which the episode is aired.

Example:

7

results.show_id

number

A unique identifier for the TV show to which the episode belongs.

Example:

1418

results.still_path

string

A relative path to an image representing the episode; often used for displaying a thumbnail.

Example:

"/k8atjbd5gAsntuhbPnFpvnvo0qn.jpg"

results.vote_average

number

The average rating given to the episode, typically on a scale of 1 to 10.

Example:

7.242

results.vote_count

number

The total number of votes or ratings received for the episode.

Example:

31

Example:

[
  {
    "air_date": "2013-10-17",
    "episode_number": 5,
    "id": 64782,
    "name": "The Workplace Proximity",
    "overview": "Amy starts working at Caltech which causes friction with Sheldon. Howard agrees with Sheldon who mentions this to Bernadette causing a big fight for the Wolowitzes.",
    "production_code": "4X5305",
    "rating": 8,
    "runtime": 22,
    "season_number": 7,
    "show_id": 1418,
    "still_path": "/k8atjbd5gAsntuhbPnFpvnvo0qn.jpg",
    "vote_average": 7.242,
    "vote_count": 31
  },
  {
    "air_date": "2013-12-08",
    "episode_number": 11,
    "id": 968782,
    "name": "Big Man in Tehran",
    "overview": "Brody's loyalty to the mission wavers when he meets a ghost from his past. As Lockhart's confirmation looms, Saul stares into the precipice between success and failure.",
    "production_code": "3WAH11",
    "rating": 9,
    "runtime": 55,
    "season_number": 3,
    "show_id": 1407,
    "still_path": "/2JYvwe7HoEkn3BQhhHCyPzhqhh5.jpg",
    "vote_average": 8,
    "vote_count": 23
  },
  {
    "air_date": "2014-03-23",
    "episode_number": 15,
    "id": 973273,
    "name": "Dramatics, Your Honor",
    "overview": "Alicia asks Cary to be her lawyer when Nelson Dubeck (Eric Bogosian) asks her to participate in a deposition; Will faces off with a new prosecutor while defending Jeffrey Grant (Hunter Parrish).",
    "production_code": "",
    "rating": 9,
    "runtime": 43,
    "season_number": 5,
    "show_id": 1435,
    "still_path": "/eGQg94nfM6EhKrxGA8A92SXe3WT.jpg",
    "vote_average": 8.2,
    "vote_count": 11
  },
  {
    "air_date": "2014-05-11",
    "episode_number": 6,
    "id": 63099,
    "name": "The Laws of Gods and Men",
    "overview": "Stannis makes a deal with the Iron Bank of Braavos. Yara and her troops storm the Dreadfort to free Theon. Meanwhile, Daenerys meets Hizdar zo Loraq and her other supplicants. And the day of Tyrion's trial has come where Tyrion faces his father.",
    "production_code": "406",
    "rating": 8.5,
    "runtime": 51,
    "season_number": 4,
    "show_id": 1399,
    "still_path": "/vKt9b7HNYhwM91C7S53zPsAWfT3.jpg",
    "vote_average": 9,
    "vote_count": 133
  },
  {
    "air_date": "2014-05-18",
    "episode_number": 7,
    "id": 63100,
    "name": "Mockingbird",
    "overview": "Tyrion gains an unlikely ally; Daario asks Dany to allow him to do what he does best; Jon's warnings about the vulnerability of the Wall are ignored; Brienne follows a new lead. ",
    "production_code": "407",
    "rating": 8.5,
    "runtime": 51,
    "season_number": 4,
    "show_id": 1399,
    "still_path": "/r7u0uELPyDkNnBZzAFVvw1XJKo5.jpg",
    "vote_average": 8.2,
    "vote_count": 116
  },
  {
    "air_date": "2014-05-16",
    "episode_number": 12,
    "id": 975339,
    "name": "Tome-wan",
    "overview": "Bedelia returns and accepts immunity to testify against Hannibal. Mason Verger plots revenge after learning of Hannibal's manipulations.",
    "production_code": "212",
    "rating": 9,
    "runtime": 43,
    "season_number": 2,
    "show_id": 40008,
    "still_path": "/pYsO5cXmjJGYUZWVDocBI3CIM6.jpg",
    "vote_average": 8.2,
    "vote_count": 32
  },
  {
    "air_date": "2014-05-23",
    "episode_number": 13,
    "id": 976285,
    "name": "Mizumono",
    "overview": "Springing their trap, Jack, Will and Alana face off with Hannibal in a bloody final showdown, but the doctor has a few surprises of his own.",
    "production_code": "213",
    "rating": 10,
    "runtime": 43,
    "season_number": 2,
    "show_id": 40008,
    "still_path": "/40jqX3XRk6W97gscX5rj4kTy411.jpg",
    "vote_average": 9,
    "vote_count": 47
  },
  {
    "air_date": "2014-06-01",
    "episode_number": 8,
    "id": 63101,
    "name": "The Mountain and the Viper",
    "overview": "Unexpected visitors arrive in Mole's Town. With assistance from Theon, Ramsay proves himself to his father, Lord Bolton. Littlefinger's motives are questioned when Sansa reveals the fate of Lysa Arryn to other lords of the Vale. Daenerys finds out a secret about Jorah Mormont. Tyrion's fate is decided.",
    "production_code": "408",
    "rating": 9.5,
    "runtime": 53,
    "season_number": 4,
    "show_id": 1399,
    "still_path": "/exdPjUiilNFUV8uUSiBBhsanAwa.jpg",
    "vote_average": 8.9,
    "vote_count": 141
  },
  {
    "air_date": "2013-09-29",
    "episode_number": 16,
    "id": 62161,
    "name": "Felina",
    "overview": "All bad things must come to an end.",
    "production_code": "",
    "rating": 9,
    "runtime": 56,
    "season_number": 5,
    "show_id": 1396,
    "still_path": "/pA0YwyhvdDXP3BEGL2grrIhq8aM.jpg",
    "vote_average": 9.2,
    "vote_count": 172
  },
  {
    "air_date": "2014-07-13",
    "episode_number": 1,
    "id": 989249,
    "name": "Night Zero",
    "overview": "When a plane lands in New York City with everyone on board dead, Dr. Ephraim Goodweather, head of the CDC’s Canary Project, and his team are called upon to investigate. Harlem pawnbroker Abraham Setrakian races to the airport, convinced that what looks at first like a mysterious viral outbreak might be the beginning of something infinitely more sinister.",
    "production_code": "XSN01001",
    "rating": 7.5,
    "runtime": 44,
    "season_number": 1,
    "show_id": 47640,
    "still_path": "/18fgFoUhfDW4PVNOnwonaRXMJMe.jpg",
    "vote_average": 7.6,
    "vote_count": 35
  },
  {
    "air_date": "2014-06-19",
    "episode_number": 1,
    "id": 976915,
    "name": "Running with the Bull",
    "overview": "Daniel’s family fears he won’t recover from his injuries and his attackers will escape justice. Judy Dean shows Bobby some unexpected affection. Ted, Jr. hides a shameful secret from his wife. Sheriff Daggett investigates Daniel’s beating.",
    "production_code": "",
    "rating": 9,
    "runtime": 47,
    "season_number": 2,
    "show_id": 46619,
    "still_path": "/8fpa0GjYpSaAaEI5f2JiP1dkrqc.jpg",
    "vote_average": 8.7,
    "vote_count": 9
  },
  {
    "air_date": "2014-08-24",
    "episode_number": 9,
    "id": 990362,
    "name": "The Garveys at Their Best",
    "overview": "Kevin tries to suppress his bad habits while tracking down a marauding deer in Mapleton. Laurie receives not-unexpected news amidst a rising sense of foreboding. Tom connects with his past, against his better judgment. Nora has a job interview; Kevin Senior receives an honor.",
    "production_code": "4X5709",
    "rating": 9,
    "runtime": 60,
    "season_number": 1,
    "show_id": 54344,
    "still_path": "/gGLWdy0ac2OryUwfGd3y0TiHTpD.jpg",
    "vote_average": 8.5,
    "vote_count": 20
  },
  {
    "air_date": "2012-07-15",
    "episode_number": 1,
    "id": 62147,
    "name": "Live Free or Die",
    "overview": "As Walt deals with the aftermath of the Casa Tranquila explosion, Hank works to wrap up his investigation of Gus' empire.",
    "production_code": "",
    "rating": 8,
    "runtime": 43,
    "season_number": 5,
    "show_id": 1396,
    "still_path": "/uShB5dWoA3xIivZ9jvwWnGCVvt4.jpg",
    "vote_average": 8.6,
    "vote_count": 122
  },
  {
    "air_date": "2012-08-26",
    "episode_number": 7,
    "id": 62153,
    "name": "Say My Name",
    "overview": "Walt takes control of business matters; Mike deals with the consequences of his actions.",
    "production_code": "",
    "rating": 8.5,
    "runtime": 48,
    "season_number": 5,
    "show_id": 1396,
    "still_path": "/2NA7ti9jsWnG4xreMEFwbq4DH1f.jpg",
    "vote_average": 8.9,
    "vote_count": 117
  },
  {
    "air_date": "2015-03-01",
    "episode_number": 1,
    "id": 1022053,
    "name": "The Battle Creek Way",
    "overview": "Jaded Det. Russ Agnew reluctantly partners with charming FBI Agent Milt Chamberlain to solve a drug-related double homicide, but while Milt investigates with the high-tech resources of the FBI, Russ prefers old-school police work and instinct.",
    "production_code": "101",
    "rating": 8,
    "runtime": 60,
    "season_number": 1,
    "show_id": 61676,
    "still_path": "/d7i0ChoPXU4VbdFWCNtFOqTZTk8.jpg",
    "vote_average": 7.4,
    "vote_count": 7
  },
  {
    "air_date": "2015-02-23",
    "episode_number": 16,
    "id": 1039439,
    "name": "The Wrong Stuff",
    "overview": "When an astronaut, training for a trip to Mars, is mysteriously killed inside a Mars simulation, Castle and Beckett don spacesuits to investigate. But when they discover no one inside the sealed simulation could have committed the murder and no one from the outside could get in, the case takes a shocking turn",
    "production_code": "716",
    "rating": 8,
    "runtime": 45,
    "season_number": 7,
    "show_id": 1419,
    "still_path": "/kg0beAZYaaLVsP3mMxVnwDcG1f8.jpg",
    "vote_average": 7.5,
    "vote_count": 13
  },
  {
    "air_date": "2015-04-10",
    "episode_number": 13,
    "id": 1036361,
    "name": "Daredevil",
    "overview": "In the season finale, a boxed-in Fisk and a desperate Murdock, Foggy and Karen are forced to play their end games.",
    "production_code": "",
    "rating": 9.5,
    "runtime": 57,
    "season_number": 1,
    "show_id": 61889,
    "still_path": "/nSCJMlJkGULVKHuisKeH9Crguy8.jpg",
    "vote_average": 8.4,
    "vote_count": 75
  },
  {
    "air_date": "2015-03-20",
    "episode_number": 1,
    "id": 1040171,
    "name": "Part 1",
    "overview": "Trouble starts when oldest son Danny Rayburn comes home for the 45th anniversary celebration of his parents' hotel in the Florida Keys' Islamorada.",
    "production_code": "",
    "rating": 8.5,
    "runtime": 60,
    "season_number": 1,
    "show_id": 61986,
    "still_path": "/qfMRZLmVPm6ubFC1NxSVRm7RLnq.jpg",
    "vote_average": 7.7,
    "vote_count": 14
  },
  {
    "air_date": "2015-05-31",
    "episode_number": 8,
    "id": 1070282,
    "name": "Hardhome",
    "overview": "Arya makes progress in her training. Sansa confronts an old friend. Cersei struggles. Jon travels.",
    "production_code": "508",
    "rating": 10,
    "runtime": 61,
    "season_number": 5,
    "show_id": 1399,
    "still_path": "/zIrSrXU4zOArlVYnXFxxfKDYYY2.jpg",
    "vote_average": 9.3,
    "vote_count": 170
  },
  {
    "air_date": "2011-04-17",
    "episode_number": 1,
    "id": 63056,
    "name": "Winter Is Coming",
    "overview": "Jon Arryn, the Hand of the King, is dead. King Robert Baratheon plans to ask his oldest friend, Eddard Stark, to take Jon's place. Across the sea, Viserys Targaryen plans to wed his sister to a nomadic warlord in exchange for an army.",
    "production_code": "101",
    "rating": 9,
    "runtime": 62,
    "season_number": 1,
    "show_id": 1399,
    "still_path": "/9hGF3WUkBf7cSjMg0cdMDHJkByd.jpg",
    "vote_average": 7.8,
    "vote_count": 285
  }
]

total_pages

number

The total number of pages available in the results.

Example:

10

total_results

number

The total number of results found for the query submitted.

Example:

186