Rated TV

This endpoint get a users list of rated TV shows.

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

page

number

Represents the current page of the results being returned. It starts from 1 and increments with each new page.

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.adult

boolean

A boolean indicating whether the movie is categorized as adult content (true) or not (false).

Example:

false

results.backdrop_path

string

The URL path to the movie's backdrop image, that can be displayed behind the movie title.

Example:

"/2yZXtM2Kky1Sy0kachbDlwybl3y.jpg"

results.first_air_date

string

This indicate the date when the show first premiered.

Example:

"2008-09-09"

results.genre_ids

number[]

An array of integers representing unique identifiers for the genres associated with the show.

Example:

[10765, 18, 9648]

results.id

number

An integer representing a unique identifier for the movie within the database.

Example:

1705

results.name

string

A string that contains the name or title of the show.

Example:

"Fringe"

results.origin_country

string[]

An array of strings indicating the country or countries where the show was produced.

Example:

["US"]

results.original_language

string

A string representing the original language in which the show was produced.

Example:

"en"

results.original_name

string

A string that contains the original title of the show.

Example:

"Fringe"

results.overview

string

A brief summary of the show, providing an insight into the story.

Example:

"FBI Special Agent Olivia Dunham, brilliant but formerly institutionalized scientist Walter Bishop and his scheming, reluctant son Peter uncover a deadly mystery involving a series of unbelievable events and realize they may be a part of a larger, more disturbing pattern that blurs the line between science fiction and technology."

results.popularity

number

A numeric value representing the popularity of the movie, calculated based on various factors such as viewership and engagement metrics.

Example:

151.906

results.poster_path

string

Indicates the path to the movie's poster image.

Example:

"/sY9hg5dLJ93RJOyKEiu1nAtBRND.jpg"

results.rating

number

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

Example:

9

results.vote_average

number

A numeric value that indicates the average rating the movie was received, generally on a scale of 0-10.

Example:

8.109

results.vote_count

number

An integer denoting the number of votes or ratings that have been submitted for the movie.

Example:

2050

Example:

[
  {
    "adult": false,
    "backdrop_path": "/2yZXtM2Kky1Sy0kachbDlwybl3y.jpg",
    "first_air_date": "2008-09-09",
    "genre_ids": [10765, 18, 9648],
    "id": 1705,
    "name": "Fringe",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Fringe",
    "overview": "FBI Special Agent Olivia Dunham, brilliant but formerly institutionalized scientist Walter Bishop and his scheming, reluctant son Peter uncover a deadly mystery involving a series of unbelievable events and realize they may be a part of a larger, more disturbing pattern that blurs the line between science fiction and technology.",
    "popularity": 151.906,
    "poster_path": "/sY9hg5dLJ93RJOyKEiu1nAtBRND.jpg",
    "rating": 9,
    "vote_average": 8.109,
    "vote_count": 2050
  },
  {
    "adult": false,
    "backdrop_path": "/dGzPJnh8YcUS4J10sNunohaXMVn.jpg",
    "first_air_date": "2004-03-21",
    "genre_ids": [37, 80, 18],
    "id": 1406,
    "name": "Deadwood",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Deadwood",
    "overview": "The story of the early days of Deadwood, South Dakota; woven around actual historic events with most of the main characters based on real people. Deadwood starts as a gold mining camp and gradually turns from a lawless wild-west community into an organized wild-west civilized town. The story focuses on the real-life characters Seth Bullock and Al Swearengen.",
    "popularity": 42.61,
    "poster_path": "/4Yp35DVbVOAWkfQUIQ7pbh3u0aN.jpg",
    "rating": 8,
    "vote_average": 8.095,
    "vote_count": 670
  },
  {
    "adult": false,
    "backdrop_path": "/cyieN1P9Xo5SvLasSUT7SaAAzfy.jpg",
    "first_air_date": "2010-03-16",
    "genre_ids": [80, 18],
    "id": 1436,
    "name": "Justified",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Justified",
    "overview": "A character drama based on the 2001 Elmore Leonard short story \"Fire in the Hole.\" Leonard's tale centers around U.S. Marshal Raylan Givens of Kentucky, a quiet but strong-willed official of the law. The tale covers his high-stakes job, as well as his strained relationships with his ex-wife and father.",
    "popularity": 56.399,
    "poster_path": "/aVYuGDlOZMCRt89fAnHTYgk3BMr.jpg",
    "rating": 8,
    "vote_average": 7.961,
    "vote_count": 558
  },
  {
    "adult": false,
    "backdrop_path": "/tMRdEsMg9MyXAkcufK9YJEeIaNW.jpg",
    "first_air_date": "1989-07-05",
    "genre_ids": [35],
    "id": 1400,
    "name": "Seinfeld",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Seinfeld",
    "overview": "A stand-up comedian and his three offbeat friends weather the pitfalls and payoffs of life in New York City in the '90s. It's a show about nothing.",
    "popularity": 164.288,
    "poster_path": "/aCw8ONfyz3AhngVQa1E2Ss4KSUQ.jpg",
    "rating": 9,
    "vote_average": 8.3,
    "vote_count": 1557
  },
  {
    "adult": false,
    "backdrop_path": "/bsNm9z2TJfe0WO3RedPGWQ8mG1X.jpg",
    "first_air_date": "2008-01-20",
    "genre_ids": [18, 80],
    "id": 1396,
    "name": "Breaking Bad",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Breaking Bad",
    "overview": "When Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime.",
    "popularity": 292.904,
    "poster_path": "/ggFHVNu6YYI5L9pCfOacjizRGt.jpg",
    "rating": 10,
    "vote_average": 8.878,
    "vote_count": 11548
  },
  {
    "adult": false,
    "backdrop_path": "/sAX6JOWZWJGhkvFRctSZIL556mp.jpg",
    "first_air_date": "2008-09-03",
    "genre_ids": [80, 18],
    "id": 1409,
    "name": "Sons of Anarchy",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Sons of Anarchy",
    "overview": "An adrenalized drama with darkly comedic undertones that explores a notorious outlaw motorcycle club’s (MC) desire to protect its livelihood while ensuring that their simple, sheltered town of Charming, California remains exactly that, charming. The MC must confront threats from drug dealers, corporate developers, and overzealous law officers. Behind the MC’s familial lifestyle and legally thriving automotive shop is a ruthless and illegal arms business driven by the seduction of money, power, and blood.",
    "popularity": 119.662,
    "poster_path": "/kiy8BHtIHAslh81rvFcZ4wbNGdY.jpg",
    "rating": 8.5,
    "vote_average": 8.442,
    "vote_count": 2437
  },
  {
    "adult": false,
    "backdrop_path": "/r9t9lblyPfudl0LV0Ujg1nXdKyW.jpg",
    "first_air_date": "2004-11-16",
    "genre_ids": [18, 9648],
    "id": 1408,
    "name": "House",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "House",
    "overview": "Dr. Gregory House, a drug-addicted, unconventional, misanthropic medical genius, leads a team of diagnosticians at the fictional Princeton–Plainsboro Teaching Hospital in New Jersey.",
    "popularity": 257.672,
    "poster_path": "/5rIQ3pTjWdZjNUJSJxn1T8MIvoG.jpg",
    "rating": 7.5,
    "vote_average": 8.607,
    "vote_count": 5450
  },
  {
    "adult": false,
    "backdrop_path": "/8X1BTSaUyF5rc0malaaQovpxC3f.jpg",
    "first_air_date": "2007-09-24",
    "genre_ids": [35],
    "id": 1418,
    "name": "The Big Bang Theory",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "The Big Bang Theory",
    "overview": "The sitcom is centered on five characters living in Pasadena, California: roommates Leonard Hofstadter and Sheldon Cooper; Penny, a waitress and aspiring actress who lives across the hall; and Leonard and Sheldon's equally geeky and socially awkward friends and co-workers, mechanical engineer Howard Wolowitz and astrophysicist Raj Koothrappali. The geekiness and intellect of the four guys is contrasted for comic effect with Penny's social skills and common sense.",
    "popularity": 134.048,
    "poster_path": "/ooBGRQBdbGzBxAVfExiO8r7kloA.jpg",
    "rating": 7,
    "vote_average": 7.879,
    "vote_count": 9899
  },
  {
    "adult": false,
    "backdrop_path": "/tK8eRUWVY8AVdDUPUxSzrmlLb0R.jpg",
    "first_air_date": "2009-10-02",
    "genre_ids": [10765, 10759, 18],
    "id": 5148,
    "name": "Stargate Universe",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Stargate Universe",
    "overview": "The adventures of a present-day, multinational exploration team traveling on the Ancient spaceship Destiny many billions of light years distant from the Milky Way Galaxy. They evacuated there and are now trying to figure out a way to return to Earth, while simultaneously trying to explore and to survive in their unknown area of the universe.",
    "popularity": 35.116,
    "poster_path": "/n23WMoa9y5TYPuKSQjPArpbHr9x.jpg",
    "rating": 7.5,
    "vote_average": 7.385,
    "vote_count": 577
  },
  {
    "adult": false,
    "backdrop_path": "/x4lxFIhhrDI4nWtV8osnYwbGESV.jpg",
    "first_air_date": "2009-09-23",
    "genre_ids": [35],
    "id": 1421,
    "name": "Modern Family",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Modern Family",
    "overview": "The Pritchett-Dunphy-Tucker clan is a wonderfully large and blended family. They give us an honest and often hilarious look into the sometimes warm, sometimes twisted, embrace of the modern family.",
    "popularity": 231.798,
    "poster_path": "/fu5vEUHgxkAPmX26ISQXqHmlPMq.jpg",
    "rating": 9,
    "vote_average": 7.787,
    "vote_count": 2159
  },
  {
    "adult": false,
    "backdrop_path": "/nVRyd8hlg0ZLxBn9RaI7mUMQLnz.jpg",
    "first_air_date": "2005-09-13",
    "genre_ids": [18, 9648, 10765],
    "id": 1622,
    "name": "Supernatural",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Supernatural",
    "overview": "When they were boys, Sam and Dean Winchester lost their mother to a mysterious and demonic supernatural force. Subsequently, their father raised them to be soldiers. He taught them about the paranormal evil that lives in the dark corners and on the back roads of America ... and he taught them how to kill it. Now, the Winchester brothers crisscross the country in their '67 Chevy Impala, battling every kind of supernatural threat they encounter along the way. ",
    "popularity": 361.403,
    "poster_path": "/KoYWXbnYuS3b0GyQPkbuexlVK9.jpg",
    "rating": 8,
    "vote_average": 8.304,
    "vote_count": 6650
  },
  {
    "adult": false,
    "backdrop_path": "/1dQHZhnej0acyQn5jlVb8NHDMDM.jpg",
    "first_air_date": "2012-06-24",
    "genre_ids": [18],
    "id": 15621,
    "name": "The Newsroom",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "The Newsroom",
    "overview": "A behind-the-scenes look at the people who make a nightly cable-news program. Focusing on a network anchor, his new executive producer, the newsroom staff and their boss, the series tracks their quixotic mission to do the news well in the face of corporate and commercial obstacles-not to mention their own personal entanglements.",
    "popularity": 22.784,
    "poster_path": "/2s6IPLtfw0GiMxlJznb1TkA6KXk.jpg",
    "rating": 8.5,
    "vote_average": 8.119,
    "vote_count": 485
  },
  {
    "adult": false,
    "backdrop_path": "/mCwQJqyuCFlbFyJR5sWg3PqtHEN.jpg",
    "first_air_date": "2013-04-04",
    "genre_ids": [18, 80],
    "id": 40008,
    "name": "Hannibal",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Hannibal",
    "overview": "Both a gift and a curse, Graham has the extraordinary ability to think like his prey—he sees what they see, feels what they feel. But while Graham is pursuing an especially troubling, cannibalistic murderer, Special Agent Jack Crawford teams him with a highly respected psychiatrist – a man with a taste for the criminal minded – Dr. Hannibal Lecter.",
    "popularity": 55.286,
    "poster_path": "/imzvb941su6uhQ158GGurk7vF28.jpg",
    "rating": 9,
    "vote_average": 8.222,
    "vote_count": 2011
  },
  {
    "adult": false,
    "backdrop_path": "/jBhcm0Rm5Uv1UaHt0TTWuRjG5G3.jpg",
    "first_air_date": "2004-09-22",
    "genre_ids": [9648, 10759],
    "id": 4607,
    "name": "Lost",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Lost",
    "overview": "Stripped of everything, the survivors of a horrific plane crash  must work together to stay alive. But the island holds many secrets.",
    "popularity": 152.944,
    "poster_path": "/og6S0aTZU6YUJAbqxeKjCa3kY1E.jpg",
    "rating": 7.5,
    "vote_average": 7.968,
    "vote_count": 3428
  },
  {
    "adult": false,
    "backdrop_path": "/2yDV0xLyqW88dn5qE7YCRnoYmfy.jpg",
    "first_air_date": "2001-09-09",
    "genre_ids": [18, 10768],
    "id": 4613,
    "name": "Band of Brothers",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Band of Brothers",
    "overview": "Drawn from interviews with survivors of Easy Company, as well as their journals and letters, Band of Brothers chronicles the experiences of these men from paratrooper training in Georgia through the end of the war. As an elite rifle company parachuting into Normandy early on D-Day morning, participants in the Battle of the Bulge, and witness to the horrors of war, the men of Easy knew extraordinary bravery and extraordinary fear - and became the stuff of legend. Based on Stephen E. Ambrose's acclaimed book of the same name.",
    "popularity": 56.008,
    "poster_path": "/pGzV187ogXzgJrvPRy2YPi29ofH.jpg",
    "rating": 9,
    "vote_average": 8.457,
    "vote_count": 2956
  },
  {
    "adult": false,
    "backdrop_path": "/ogZMFPQbkv4gGYjVt9vA35eTpee.jpg",
    "first_air_date": "2010-09-08",
    "genre_ids": [80, 18, 35],
    "id": 33400,
    "name": "Terriers",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Terriers",
    "overview": "Ex-cop and recovering alcoholic Hank Dolworth partners with his best friend, former criminal Britt Pollack, in an unlicensed private investigation business. The series is set in Ocean Beach, San Diego, California, although it is portrayed as a distinct town, with Dolworth having once been a member of the fictional Ocean Beach Police Department.",
    "popularity": 8.858,
    "poster_path": "/51T6VEO74kijlt2SDowGiiq0Cti.jpg",
    "rating": 8,
    "vote_average": 8.135,
    "vote_count": 78
  },
  {
    "adult": false,
    "backdrop_path": "/gNYLylxp5EzopGtIb4XqIzbLtNJ.jpg",
    "first_air_date": "2010-09-19",
    "genre_ids": [80, 18],
    "id": 1621,
    "name": "Boardwalk Empire",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Boardwalk Empire",
    "overview": "Atlantic City at the dawn of Prohibition is a place where the rules don't apply. And the man who runs things -- legally and otherwise -- is the town's treasurer, Enoch \"Nucky\" Thompson, who is equal parts politician and gangster.",
    "popularity": 32.102,
    "poster_path": "/kL6SqlVPpfAof2nQbh1VxkUuXBQ.jpg",
    "rating": 8.5,
    "vote_average": 8,
    "vote_count": 862
  },
  {
    "adult": false,
    "backdrop_path": "/7sJrNKwzyJWnFPFpDL9wnZ859LZ.jpg",
    "first_air_date": "2012-09-27",
    "genre_ids": [18, 9648, 80],
    "id": 1415,
    "name": "Elementary",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Elementary",
    "overview": "A modern-day drama about a crime-solving duo that cracks the NYPD's most impossible cases. Following his fall from grace in London and a stint in rehab, eccentric Sherlock escapes to Manhattan where his wealthy father forces him to live with his worst nightmare - a sober companion, Dr. Watson.",
    "popularity": 134.614,
    "poster_path": "/q9dObe29W4bDpgzUfOOH3ZnzDbR.jpg",
    "rating": 7,
    "vote_average": 7.563,
    "vote_count": 1406
  },
  {
    "adult": false,
    "backdrop_path": "/OylSdzVezjwGLYM0w73mUPNHM4.jpg",
    "first_air_date": "2009-09-17",
    "genre_ids": [35],
    "id": 18347,
    "name": "Community",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "Community",
    "overview": "Follow the lives of a group of students at what is possibly the world’s worst community college in the fictional locale of Greendale, Colorado.",
    "popularity": 75.864,
    "poster_path": "/3KUjDt8XY7w2Ku70UE0SECmv1zP.jpg",
    "rating": 7.5,
    "vote_average": 7.957,
    "vote_count": 1327
  },
  {
    "adult": false,
    "backdrop_path": "/qoauOMsZq2GXBxVj05Oga0IYPbX.jpg",
    "first_air_date": "2009-09-30",
    "genre_ids": [35],
    "id": 1422,
    "name": "The Middle",
    "origin_country": ["US"],
    "original_language": "en",
    "original_name": "The Middle",
    "overview": "The daily mishaps of a married woman and her semi-dysfunctional family and their attempts to survive life in general in the city of Orson, Indiana.",
    "popularity": 129.786,
    "poster_path": "/7YwLY7Fg9BJU9qu9rrwaYbIc77c.jpg",
    "rating": 7.5,
    "vote_average": 7.546,
    "vote_count": 545
  }
]

total_pages

number

The total number of pages available for the query results.

Example:

15

total_results

number

The total number of results that meet the criteria of the query.

Example:

290