> ## Documentation Index
> Fetch the complete documentation index at: https://biscon.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Top Rated

> This endpoint get a list of TV shows ordered by rating.




## OpenAPI

````yaml get /tv/top_rated
openapi: 3.0.3
info:
  title: TMDB API DOCUMENTATION
  description: >-
    The Movie Database is an API that provides comprehensive movie, TV show, and
    celebrity data. TMDB offers APIs that developers use to access and integrate
    its data into applications, websites, or services.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Endpoints for managing authentication, including login and user sessions.
  - name: Account
    description: Endpoints for managing user accounts, such as profiles and settings.
  - name: Certification
    description: Endpoints for retrieving and managing certification data.
  - name: Changes
    description: Endpoints for tracking changes and updates across the system.
  - name: Collection
    description: Endpoints for managing and accessing user collections.
  - name: Companies
    description: Endpoints for retrieving and managing company-related data.
  - name: Configuration
    description: Endpoints for accessing and updating system configuration settings.
  - name: Credits
    description: Endpoints for retrieving credit information related to movies or shows.
  - name: Discover
    description: Endpoints for discovering content based on filters and criteria.
  - name: Find
    description: Endpoints for locating specific items or entities in the database.
  - name: Genres
    description: Endpoints for retrieving and managing genres for categorization.
  - name: Guest Sessions
    description: Endpoints for creating and managing guest user sessions.
  - name: Keywords
    description: Endpoints for managing and searching content using keywords.
  - name: Lists
    description: Endpoints for creating and managing user-generated lists.
  - name: Movie Lists
    description: Endpoints for retrieving and managing lists of movies.
  - name: Movies
    description: Endpoints for retrieving detailed information about movies.
  - name: Networks
    description: Endpoints for retrieving and managing network-related data.
  - name: People Lists
    description: Endpoints for retrieving and managing lists of people in the system.
  - name: People
    description: Endpoints for retrieving information about actors, directors, and others.
  - name: Search
    description: Endpoints for performing searches across multiple categories.
  - name: Reviews
    description: Endpoints for managing and displaying reviews from users.
  - name: Trending
    description: Endpoints for retrieving trending content based on popularity.
  - name: TV Series Lists
    description: Endpoints for retrieving and managing lists of TV series.
  - name: TV Series
    description: Endpoints for retrieving detailed information about TV series.
  - name: TV Seasons
    description: Endpoints for retrieving and managing information about TV seasons.
  - name: TV Episodes
    description: Endpoints for retrieving and managing information about TV episodes.
  - name: TV Episode Groups
    description: Endpoints for managing groups of TV episodes organized by criteria.
  - name: Watch Providers
    description: >-
      Endpoints for retrieving availability information from streaming
      providers.
  - name: Auth
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
  - name: Lists
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
paths:
  /tv/top_rated:
    get:
      tags:
        - TV Series Lists
      summary: Top Rated
      description: |
        This endpoint get a list of TV shows ordered by rating.
      operationId: tvseriesAiringToday
      parameters:
        - name: language
          in: query
          required: false
          description: Defaults to en-US
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: integer
          description: Default to 1
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                    description: Indicates the current page number
                  results:
                    type: array
                    description: Contains the list of data or items
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                        backdrop_path:
                          type: string
                        id:
                          type: integer
                        name:
                          type: string
                        original_language:
                          type: string
                        original_title:
                          type: string
                        overview:
                          type: string
                        poster_path:
                          type: string
                        media_type:
                          type: string
                        genre_ids:
                          type: array
                        popularity:
                          type: number
                        first_air_date:
                          type: string
                        video:
                          type: boolean
                        vote_average:
                          type: number
                        vote_count:
                          type: integer
                  total_pages:
                    type: integer
                    description: Specifies the total number of pages available
                  total_results:
                    type: integer
                    description: >-
                      Represents the total number of items or records in a
                      dataset
                example:
                  page: 1
                  results:
                    - adult: false
                      backdrop_path: /gc8PfyTqzqltKPW3X0cIVUGmagz.jpg
                      genre_ids:
                        - 18
                        - 80
                      id: 1396
                      origin_country:
                        - US
                      original_language: en
                      original_name: Breaking Bad
                      overview: >-
                        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: 875.261
                      poster_path: /ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg
                      first_air_date: '2008-01-20'
                      name: Breaking Bad
                      vote_average: 8.918
                      vote_count: 14799
                    - adult: false
                      backdrop_path: /lJuQBW4w1x6NgD514xDPqZ2Lbpz.jpg
                      genre_ids:
                        - 16
                        - 18
                        - 9648
                      id: 220542
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: 薬屋のひとりごと
                      overview: >-
                        Maomao lived a peaceful life with her apothecary father.
                        Until one day, she's sold as a lowly servant to the
                        emperor's palace. But she wasn't meant for a compliant
                        life among royalty. So when imperial heirs fall ill, she
                        decides to step in and find a cure! This catches the eye
                        of Jinshi, a handsome palace official who promotes her.
                        Now, she's making a name for herself solving medical
                        mysteries!
                      popularity: 159.11
                      poster_path: /e3ojpANrFnmJCyeBNTinYwyBCIN.jpg
                      first_air_date: '2023-10-22'
                      name: The Apothecary Diaries
                      vote_average: 8.839
                      vote_count: 208
                    - adult: false
                      backdrop_path: /96RT2A47UdzWlUfvIERFyBsLhL2.jpg
                      genre_ids:
                        - 16
                        - 10759
                        - 10765
                        - 18
                      id: 209867
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: 葬送のフリーレン
                      overview: >-
                        After the party of heroes defeated the Demon King, they
                        restored peace to the land and returned to lives of
                        solitude. Generations pass, and the elven mage Frieren
                        comes face to face with humanity’s mortality. She takes
                        on a new apprentice and promises to fulfill old friends’
                        dying wishes. Can an elven mind make peace with the
                        nature of life and death? Frieren embarks on her quest
                        to find out.
                      popularity: 151.976
                      poster_path: /dqZENchTd7lp5zht7BdlqM7RBhD.jpg
                      first_air_date: '2023-09-29'
                      name: 'Frieren: Beyond Journey''s End'
                      vote_average: 8.833
                      vote_count: 353
                    - adult: false
                      backdrop_path: /jlbUx0aHJupDVDlCo0R7UxSaUUd.jpg
                      genre_ids:
                        - 16
                        - 10759
                        - 35
                        - 10765
                      id: 240411
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: ダンダダン
                      overview: >-
                        In a bet to prove whether ghosts or aliens exist, two
                        high schoolers face terrifying paranormal threats, gain
                        superpowers and maybe even fall in love?!
                      popularity: 336.099
                      poster_path: /6qfZAOEUFIrbUH3JvePclx1nXzz.jpg
                      first_air_date: '2024-10-04'
                      name: Dan Da Dan
                      vote_average: 8.8
                      vote_count: 342
                    - adult: false
                      backdrop_path: /tuCU2yVRM2iZxFkpqlPUyvd6tSu.jpg
                      genre_ids:
                        - 16
                        - 35
                        - 10765
                      id: 94954
                      origin_country:
                        - US
                      original_language: en
                      original_name: Hazbin Hotel
                      overview: >-
                        In attempt to find a non-violent alternative for
                        reducing Hell's overpopulation, the daughter of Lucifer
                        opens a rehabilitation hotel that offers a group of
                        misfit demons a chance at redemption.
                      popularity: 116.182
                      poster_path: /rXojaQcxVUubPLSrFV8PD4xdjrs.jpg
                      first_air_date: '2024-01-18'
                      name: Hazbin Hotel
                      vote_average: 8.807
                      vote_count: 1192
                    - adult: false
                      backdrop_path: /sYXLeu5usz6yEz0k00FYvtEdodD.jpg
                      genre_ids:
                        - 16
                        - 10765
                        - 18
                        - 10759
                      id: 94605
                      origin_country:
                        - US
                      original_language: en
                      original_name: Arcane
                      overview: >-
                        Amid the stark discord of twin cities Piltover and Zaun,
                        two sisters fight on rival sides of a war between magic
                        technologies and clashing convictions.
                      popularity: 468.709
                      poster_path: /abf8tHznhSvl9BAElD2cQeRr7do.jpg
                      first_air_date: '2021-11-06'
                      name: Arcane
                      vote_average: 8.776
                      vote_count: 4737
                    - adult: false
                      backdrop_path: /jvFfHNiCKPWRULvkmeocyjm4QtE.jpg
                      genre_ids:
                        - 18
                      id: 129888
                      origin_country:
                        - KR
                      original_language: ko
                      original_name: 스물다섯 스물하나
                      overview: >-
                        In a time when dreams seem out of reach, a teen fencer
                        pursues big ambitions and meets a hardworking young man
                        who seeks to rebuild his life.
                      popularity: 110.446
                      poster_path: /yCQFnmYhYf7XALMka2EoBRAFmPO.jpg
                      first_air_date: '2022-02-12'
                      name: Twenty Five Twenty One
                      vote_average: 8.762
                      vote_count: 214
                    - adult: false
                      backdrop_path: /cJdnkIrD9vcIUiCbWjay55qoaQz.jpg
                      genre_ids:
                        - 16
                        - 10759
                        - 10765
                      id: 246
                      origin_country:
                        - US
                      original_language: en
                      original_name: 'Avatar: The Last Airbender'
                      overview: >-
                        In a war-torn world of elemental magic, a young boy
                        reawakens to undertake a dangerous mystic quest to
                        fulfill his destiny as the Avatar, and bring peace to
                        the world.
                      popularity: 107.486
                      poster_path: /9RQhVb3r3mCMqYVhLoCu4EvuipP.jpg
                      first_air_date: '2005-02-21'
                      name: 'Avatar: The Last Airbender'
                      vote_average: 8.7
                      vote_count: 4184
                    - adult: false
                      backdrop_path: /4Mt7WHox67uJ1yErwTBFcV8KWgG.jpg
                      genre_ids:
                        - 10759
                        - 35
                        - 16
                      id: 37854
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: ワンピース
                      overview: >-
                        Years ago, the fearsome Pirate King, Gol D. Roger was
                        executed leaving a huge pile of treasure and the famous
                        "One Piece" behind. Whoever claims the "One Piece" will
                        be named the new King of the Pirates.


                        Monkey D. Luffy, a boy who consumed a "Devil Fruit,"
                        decides to follow in the footsteps of his idol, the
                        pirate Shanks, and find the One Piece. It helps, of
                        course, that his body has the properties of rubber and
                        that he's surrounded by a bevy of skilled fighters and
                        thieves to help him along the way.


                        Luffy will do anything to get the One Piece and become
                        King of the Pirates!
                      popularity: 277.678
                      poster_path: /cMD9Ygz11zjJzAovURpO75Qg7rT.jpg
                      first_air_date: '1999-10-20'
                      name: One Piece
                      vote_average: 8.721
                      vote_count: 4750
                    - adult: false
                      backdrop_path: /jmV6NIzZxGzRoljFPwao6sh4Nny.jpg
                      genre_ids:
                        - 18
                        - 35
                      id: 259666
                      origin_country:
                        - MX
                      original_language: es
                      original_name: Nadie nos va a extrañar
                      overview: >-
                        It's the '90s, and five losers run an illegal business
                        at their high school. They sell homework and assignments
                        to their classmates. The advantage is that no one ever
                        suspects the nerds. Their business brings them money and
                        popularity. But hormones and an unexpected death
                        threaten to ruin everything. If the business collapses,
                        their futures and their friendships are at risk.
                      popularity: 64.009
                      poster_path: /py0s87C9214KRbZ4kWLQfgsE9ET.jpg
                      first_air_date: '2024-08-09'
                      name: No One Will Miss Us
                      vote_average: 8.7
                      vote_count: 201
                    - adult: false
                      backdrop_path: /A6tMQAo6t6eRFCPhsrShmxZLqFB.jpg
                      genre_ids:
                        - 10759
                        - 16
                        - 10765
                        - 35
                      id: 31911
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: 鋼の錬金術師 FULLMETAL ALCHEMIST
                      overview: >-
                        Disregard for alchemy’s laws ripped half of Edward
                        Elric’s limbs from his body and left his brother
                        Alphonse’s soul clinging to a suit of armor. To restore
                        what was lost, the brothers seek the Philosopher’s
                        Stone. Enemies and allies – the corrupt military, the
                        Homunculi, and foreign alchemists – will alter the Elric
                        brothers course, but their purpose will remain unchanged
                        and their bond unbreakable.
                      popularity: 164.286
                      poster_path: /5ZFUEOULaVml7pQuXxhpR2SmVUw.jpg
                      first_air_date: '2009-04-05'
                      name: 'Fullmetal Alchemist: Brotherhood'
                      vote_average: 8.7
                      vote_count: 2092
                    - adult: false
                      backdrop_path: /8aCek7W6BovH7M4enWjqrGptvQ8.jpg
                      genre_ids:
                        - 16
                        - 35
                        - 10765
                        - 10759
                      id: 60625
                      origin_country:
                        - US
                      original_language: en
                      original_name: Rick and Morty
                      overview: >-
                        Rick is a mentally-unbalanced but scientifically gifted
                        old man who has recently reconnected with his family. He
                        spends most of his time involving his young grandson
                        Morty in dangerous, outlandish adventures throughout
                        space and alternate universes. Compounded with Morty's
                        already unstable family life, these events cause Morty
                        much distress at home and school.
                      popularity: 505.821
                      poster_path: /gdIrmf2DdY5mgN6ycVP0XlzKzbE.jpg
                      first_air_date: '2013-12-02'
                      name: Rick and Morty
                      vote_average: 8.7
                      vote_count: 9870
                    - adult: false
                      backdrop_path: /og2jKploGHYnCz68vV1nRSEE0xV.jpg
                      genre_ids:
                        - 80
                        - 18
                      id: 60059
                      origin_country:
                        - US
                      original_language: en
                      original_name: Better Call Saul
                      overview: >-
                        Six years before Saul Goodman meets Walter White. We
                        meet him when the man who will become Saul Goodman is
                        known as Jimmy McGill, a small-time lawyer searching for
                        his destiny, and, more immediately, hustling to make
                        ends meet. Working alongside, and, often, against Jimmy,
                        is “fixer” Mike Ehrmantraut. The series tracks Jimmy’s
                        transformation into Saul Goodman, the man who puts
                        “criminal” in “criminal lawyer".
                      popularity: 364.43
                      poster_path: /zjg4jpK1Wp2kiRvtt5ND0kznako.jpg
                      first_air_date: '2015-02-08'
                      name: Better Call Saul
                      vote_average: 8.7
                      vote_count: 5348
                    - adult: false
                      backdrop_path: /20eIP9o5ebArmu2HxJutaBjhLf4.jpg
                      genre_ids:
                        - 18
                      id: 87108
                      origin_country:
                        - US
                      original_language: en
                      original_name: Chernobyl
                      overview: >-
                        The true story of one of the worst man-made catastrophes
                        in history: the catastrophic nuclear accident at
                        Chernobyl. A tale of the brave men and women who
                        sacrificed to save Europe from unimaginable disaster.
                      popularity: 211.924
                      poster_path: /7vcwOySsqeyEdmfHQNT5jHCL2gb.jpg
                      first_air_date: '2019-05-06'
                      name: Chernobyl
                      vote_average: 8.7
                      vote_count: 6463
                    - adult: false
                      backdrop_path: /ywQtHG17LZhAFZyZtBflhtFMtJ7.jpg
                      genre_ids:
                        - 18
                        - 10751
                      id: 70785
                      origin_country:
                        - CA
                      original_language: en
                      original_name: Anne with an E
                      overview: >-
                        A coming-of-age story about an outsider who, against all
                        odds and numerous challenges, fights for love and
                        acceptance and for her place in the world. The series
                        centers on a young orphaned girl in the late 1890’s,
                        who, after an abusive childhood spent in orphanages and
                        the homes of strangers, is mistakenly sent to live with
                        an elderly woman and her aging brother. Over time,
                        13-year-old Anne will transform their lives and
                        eventually the small town in which they live with her
                        unique spirit, fierce intellect and brilliant
                        imagination.
                      popularity: 146.973
                      poster_path: /6P6tXhjT5tK3qOXzxF9OMLlG7iz.jpg
                      first_air_date: '2017-03-19'
                      name: Anne with an E
                      vote_average: 8.666
                      vote_count: 4672
                    - adult: false
                      backdrop_path: /yvKrycViRMQcIgdnjsM5JGNWU4Q.jpg
                      genre_ids:
                        - 16
                        - 10765
                        - 10759
                      id: 1429
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: 進撃の巨人
                      overview: >-
                        Many years ago, the last remnants of humanity were
                        forced to retreat behind the towering walls of a
                        fortified city to escape the massive, man-eating Titans
                        that roamed the land outside their fortress. Only the
                        heroic members of the Scouting Legion dared to stray
                        beyond the safety of the walls – but even those brave
                        warriors seldom returned alive. Those within the city
                        clung to the illusion of a peaceful existence until the
                        day that dream was shattered, and their slim chance at
                        survival was reduced to one horrifying choice: kill – or
                        be devoured!
                      popularity: 139.05
                      poster_path: /hTP1DtLGFamjfu8WqjnuQdP1n4i.jpg
                      first_air_date: '2013-04-07'
                      name: Attack on Titan
                      vote_average: 8.7
                      vote_count: 6502
                    - adult: false
                      backdrop_path: /iKIyTYNYsQB05EspmjrX468UTmL.jpg
                      genre_ids:
                        - 10765
                        - 18
                        - 10759
                        - 9648
                      id: 135157
                      origin_country:
                        - KR
                      original_language: ko
                      original_name: 환혼
                      overview: >-
                        A powerful sorceress in a blind woman's body encounters
                        a man from a prestigious family, who wants her help to
                        change his destiny.
                      popularity: 181.952
                      poster_path: /q2IiPRSXPOZ6qVRj36WRAYEQyHs.jpg
                      first_air_date: '2022-06-18'
                      name: Alchemy of Souls
                      vote_average: 8.665
                      vote_count: 619
                    - adult: false
                      backdrop_path: /7BoRhg8zXP0ca9Zql4p8llCFR2P.jpg
                      genre_ids:
                        - 18
                        - 10765
                        - 35
                      id: 221851
                      origin_country:
                        - KR
                      original_language: ko
                      original_name: 내 남편과 결혼해줘
                      overview: >-
                        Kang Ji-won, a terminally ill cancer patient, is killed
                        by her husband and best friend after she witnesses them
                        having an affair. She wakes up 10 years before the
                        incident and decides to seek revenge with the help of Yu
                        Ji-hyuk, a director at the company where she works. Now,
                        she must reclaim her fate and eliminate the trash from
                        her life.
                      popularity: 123.869
                      poster_path: /y2hvE76S6Me0uhYEQ1P8lGf7Wm0.jpg
                      first_air_date: '2024-01-01'
                      name: Marry My Husband
                      vote_average: 8.667
                      vote_count: 482
                    - adult: false
                      backdrop_path: /2w8FaLwwJTWr6ExUMeVgT2Th5YT.jpg
                      genre_ids:
                        - 16
                        - 35
                        - 18
                        - 10759
                      id: 42705
                      origin_country:
                        - JP
                      original_language: ja
                      original_name: はじめの一歩
                      overview: >-
                        Makunouchi Ippo is an ordinary high school student in
                        Japan. Since he spends most of his time away from school
                        helping his mother run the family business, he doesn't
                        get to enjoy his younger years like most teenagers.
                        Always a target for bullying at school (the family
                        fishing business grants him a distinct odor), Ippo's
                        life is one of hardship. One of these after-school
                        bullying sessions turns Ippo's life around for the
                        better, as he is saved by a boxer named Takamura. He
                        decides to follow in Takamura's footsteps and train to
                        become a boxer, giving his life direction and purpose.
                        Ippo's path to perfecting his pugilistic prowess is just
                        beginning...
                      popularity: 1014.548
                      poster_path: /1LApB9C9kEkh2ZU2vzAhurNDipl.jpg
                      first_air_date: '2000-10-03'
                      name: Fighting Spirit
                      vote_average: 8.7
                      vote_count: 1087
                    - adult: false
                      backdrop_path: /mGHrUSt2uA5RaIheSmBfRnRHPS8.jpg
                      genre_ids:
                        - 16
                        - 10765
                        - 18
                        - 10759
                        - 35
                        - 10762
                      id: 92685
                      origin_country:
                        - US
                      original_language: en
                      original_name: The Owl House
                      overview: >-
                        An animated fantasy-comedy series that follows Luz, a
                        self-assured teenage girl who accidentally stumbles upon
                        a portal to a magical world where she befriends a
                        rebellious witch, Eda, and an adorably tiny warrior,
                        King. Despite not having magical abilities, Luz pursues
                        her dream of becoming a witch by serving as Eda's
                        apprentice at the Owl House and ultimately finds a new
                        family in an unlikely setting.
                      popularity: 142.242
                      poster_path: /zqjSex7DZn7p4dU7mMktdJ8zQV5.jpg
                      first_air_date: '2020-01-10'
                      name: The Owl House
                      vote_average: 8.7
                      vote_count: 1612
                  total_pages: 106
                  total_results: 2103
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.