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

# TV Shows

> This endpoint searches for TV shows by their original, translated and also known as names.



## OpenAPI

````yaml get /3/search/tv
openapi: 3.0.3
info:
  title: TMDb Endpoints
  description: >-
    Welcome to the TMDb API! You'll find a well-organized collection of
    endpoints, each helping you fetch different types of movie and TV data. The
    endpoints cover everything from searching for titles and getting details to
    managing lists and accessing ratings, all designed to give you precise
    control over the information you need.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
    description: Test server
  - url: https://api.themoviedb.org/3
    description: Production server
  - url: '{{base_url}}'
    description: Some other server
security: []
tags:
  - name: AUTHENTICATION
    description: The /account/{account_id} gets the public details of an account on TMDB.
  - name: ACCOUNT
    description: >-
      Account endpoints allow users to manage their personal information,
      ratings, watchlists, and other account-related data after authenticating.
  - name: CERTIFICATIONS
    description: >-
      The Certifications endpoints provide lists of movie and TV show content
      rating systems used in various countries.
  - name: CHANGES
    description: >-
      Changes endpoints allow you to track modifications made to movies, TV
      shows, and people in the TMDb database, providing a history of updates and
      enabling you to keep your local data synchronized.
  - name: COLLECTIONS
  - name: COMPANIES
  - name: CONFIGURATION
  - name: CREDITS
  - name: DISCOVER
    description: >-
      Discover endpoints are powerful tools for finding movies and TV shows
      based on a wide range of criteria, such as genre, release date, rating,
      keywords, and more, enabling highly customized searches.
  - name: FIND
    description: This folder has find by ID endpoint
  - name: GENRES
    description: >-
      Genres endpoints provide lists of available movie and TV show genres,
      allowing you to categorize and filter content.
  - name: GUEST SESSIONS
    description: >-
      Guest session endpoints allow you to create temporary, unauthenticated
      sessions that grant limited access to certain API features, such as rating
      movies or TV shows without requiring a full user account.
  - name: KEYWORDS
    description: >-
      Keyword endpoints allow you to search for keywords and retrieve detailed
      information about specific keywords and the media associated with them.
  - name: LISTS
    description: >-
      Lists endpoints allow you to create, retrieve, modify, and delete custom
      lists of movies or TV shows.
  - name: MOVIE LIST
    description: >-
      The Movie List endpoints let you retrieve pre-made lists of movies,
      categorized by criteria like popularity, top rated, now playing, or
      upcoming releases.
  - name: MOVIES
    description: >-
      The Movie endpoints allow you to retrieve detailed information about
      movies, including titles, descriptions, cast, crew, ratings, and related
      data.
  - name: NETWORKS
    description: >-
      The NETWORKS endpoints let you retrieve information about television
      networks, such as their names, logos, and origin countries.
  - name: PEOPLE LISTS
    description: >-
      The People Lists endpoints let you retrieve lists of people based on
      criteria like popularity.
  - name: PEOPLE
    description: >-
      The PEOPLE endpoints let you get information about actors, directors, and
      other people involved in movies and TV shows.
  - name: REVIEWS
    description: >-
      The REVIEWS endpoints let you get user-written opinions and ratings about
      movies and TV shows.
  - name: SEARCH
    description: >-
      The "Search" endpoints let you find movies, TV shows, people, and other
      content by typing in keywords or names.
  - name: TRENDING
    description: >-
      The "Trending" endpoints show you what movies, TV shows, and people are
      currently popular or getting a lot of attention right now.
  - name: TV SERIES LISTS
    description: >-
      TV Series Lists endpoints provide access to pre-defined lists of TV shows,
      such as popular, top-rated, or airing today, allowing you to quickly
      retrieve collections of TV series based on specific criteria.
  - name: TV SERIES
    description: >-
      The TV series endpoints provide access to a wealth of information about
      television shows, including details, credits, seasons, episodes,
      recommendations, and more. See each of them below for specific
      information.
  - name: TV SEASONS
    description: >-
      The TV seasons endpoints allow you to retrieve details about specific
      seasons of a TV show, including information about the episodes within that
      season. See them below for specific information on how to use them.
  - name: TV EPISODES
    description: >-
      The TV episode endpoints allow you to retrieve detailed information about
      specific episodes of a TV show, including details like the episode number,
      name, air date, overview, and more. Check them out for specific
      information.
  - name: TV EPISODE GROUPS
    description: >-
      There's only one endpoint in this folder. Check the endpoint to find
      information about it.
  - name: WATCH PROVIDERS
    description: >-
      The Watch Providers endpoints provide information about streaming
      services, rental/purchase platforms, and sometimes even theatrical
      releases in different regions.
paths:
  /3/search/tv:
    get:
      tags:
        - SEARCH
      summary: TV Shows
      description: >-
        This endpoint searches for TV shows by their original, translated and
        also known as names.
      operationId: tvShows
      parameters:
        - name: query
          in: query
          schema:
            type: string
            example: game%20of%20thrones
        - name: include_adult
          in: query
          schema:
            type: string
            example: 'false'
        - name: language
          in: query
          schema:
            type: string
            example: en-US
        - name: page
          in: query
          schema:
            type: string
            example: '1'
      responses:
        '200':
          description: TV Shows Example
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=18974
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Sun, 12 Jan 2025 15:50:59 GMT
            ETag:
              schema:
                type: string
                example: W/"c6e741e189d193b1372b86047c0612cd"
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 5f56e7df8387a5dd3295f126e9d480d0.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: v8N6sAY6WXlnvWy7i8z3IhNU19xorLOuiiZJ2mG_G9po0xb-N_e8XQ==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-P2
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '7363'
            x-memc-expires:
              schema:
                type: string
                example: '18974'
            x-memc-key:
              schema:
                type: string
                example: a4e4f031408cc0603358b35c477701e8
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: number
                    example: 1
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                          example: false
                        backdrop_path:
                          type: string
                          example: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg
                        first_air_date:
                          type: string
                          example: '2011-04-17'
                        genre_ids:
                          type: array
                          items:
                            type: number
                            example: 10765
                          example:
                            - 10765
                            - 18
                            - 10759
                        id:
                          type: number
                          example: 1399
                        name:
                          type: string
                          example: Game of Thrones
                        origin_country:
                          type: array
                          items:
                            type: string
                            example: US
                          example:
                            - US
                        original_language:
                          type: string
                          example: en
                        original_name:
                          type: string
                          example: Game of Thrones
                        overview:
                          type: string
                          example: >-
                            Seven noble families fight for control of the
                            mythical land of Westeros. Friction between the
                            houses leads to full-scale war. All while a very
                            ancient evil awakens in the farthest north. Amidst
                            the war, a neglected military order of misfits, the
                            Night's Watch, is all that stands between the realms
                            of men and icy horrors beyond.
                        popularity:
                          type: number
                          example: 892.36
                        poster_path:
                          type: string
                          example: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg
                        vote_average:
                          type: number
                          example: 8.456
                        vote_count:
                          type: number
                          example: 24408
                    example:
                      - adult: false
                        backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg
                        first_air_date: '2011-04-17'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 1399
                        name: Game of Thrones
                        origin_country:
                          - US
                        original_language: en
                        original_name: Game of Thrones
                        overview: >-
                          Seven noble families fight for control of the mythical
                          land of Westeros. Friction between the houses leads to
                          full-scale war. All while a very ancient evil awakens
                          in the farthest north. Amidst the war, a neglected
                          military order of misfits, the Night's Watch, is all
                          that stands between the realms of men and icy horrors
                          beyond.
                        popularity: 892.36
                        poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg
                        vote_average: 8.456
                        vote_count: 24408
                      - adult: false
                        backdrop_path: /q0EfVHIIxCyCqUKNEvtGqx4iZig.jpg
                        first_air_date: '2021-04-05'
                        genre_ids:
                          - 10767
                        id: 206584
                        name: The Game of Thrones Reunion Hosted by Conan O'Brien
                        origin_country:
                          - US
                        original_language: en
                        original_name: The Game of Thrones Reunion Hosted by Conan O'Brien
                        overview: >-
                          A two-part reunion show with cast members from the
                          final season including Kit Harington, Emilia Clarke,
                          Sophie Turner and more, as well as previously departed
                          fan-favorites like Sean Bean, Jason Momoa, Mark Addy
                          and others.
                        popularity: 6.041
                        poster_path: /xwq2TALKkuCujBnUTpr57wDO61y.jpg
                        vote_average: 8.2
                        vote_count: 8
                      - adult: false
                        backdrop_path: /etj8E2o0Bud0HkONVQPjyCkIvpv.jpg
                        first_air_date: '2022-08-21'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 94997
                        name: House of the Dragon
                        origin_country:
                          - US
                        original_language: en
                        original_name: House of the Dragon
                        overview: >-
                          The Targaryen dynasty is at the absolute apex of its
                          power, with more than 15 dragons under their yoke.
                          Most empires crumble from such heights. In the case of
                          the Targaryens, their slow fall begins when King
                          Viserys breaks with a century of tradition by naming
                          his daughter Rhaenyra heir to the Iron Throne. But
                          when Viserys later fathers a son, the court is shocked
                          when Rhaenyra retains her status as his heir, and
                          seeds of division sow friction across the realm.
                        popularity: 341.675
                        poster_path: /t9XkeE7HzOsdQcDDDapDYh8Rrmt.jpg
                        vote_average: 8.4
                        vote_count: 5099
                      - adult: false
                        backdrop_path: /oGXuxNzrZ9QNuYYd7N4Zb9V6YKl.jpg
                        first_air_date: ''
                        genre_ids:
                          - 18
                          - 10765
                        id: 224372
                        name: 'A Knight of the Seven Kingdoms: The Hedge Knight'
                        origin_country:
                          - US
                        original_language: en
                        original_name: 'A Knight of the Seven Kingdoms: The Hedge Knight'
                        overview: >-
                          Set in an age when the Targaryen line still holds the
                          Iron Throne and the memory of the last dragon has not
                          yet passed from living memory, great destinies,
                          powerful foes and dangerous exploits all await these
                          improbable and incomparable friends.
                        popularity: 15.961
                        poster_path: /7Pb4gk51oUKWarOhvaSgf5RekIj.jpg
                        vote_average: 0
                        vote_count: 0
                  total_pages:
                    type: number
                    example: 1
                  total_results:
                    type: number
                    example: 4
              examples:
                TV Shows Example:
                  value:
                    page: 1
                    results:
                      - adult: false
                        backdrop_path: /zZqpAXxVSBtxV9qPBcscfXBcL2w.jpg
                        first_air_date: '2011-04-17'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 1399
                        name: Game of Thrones
                        origin_country:
                          - US
                        original_language: en
                        original_name: Game of Thrones
                        overview: >-
                          Seven noble families fight for control of the mythical
                          land of Westeros. Friction between the houses leads to
                          full-scale war. All while a very ancient evil awakens
                          in the farthest north. Amidst the war, a neglected
                          military order of misfits, the Night's Watch, is all
                          that stands between the realms of men and icy horrors
                          beyond.
                        popularity: 892.36
                        poster_path: /1XS1oqL89opfnbLl8WnZY1O1uJx.jpg
                        vote_average: 8.456
                        vote_count: 24408
                      - adult: false
                        backdrop_path: /q0EfVHIIxCyCqUKNEvtGqx4iZig.jpg
                        first_air_date: '2021-04-05'
                        genre_ids:
                          - 10767
                        id: 206584
                        name: The Game of Thrones Reunion Hosted by Conan O'Brien
                        origin_country:
                          - US
                        original_language: en
                        original_name: The Game of Thrones Reunion Hosted by Conan O'Brien
                        overview: >-
                          A two-part reunion show with cast members from the
                          final season including Kit Harington, Emilia Clarke,
                          Sophie Turner and more, as well as previously departed
                          fan-favorites like Sean Bean, Jason Momoa, Mark Addy
                          and others.
                        popularity: 6.041
                        poster_path: /xwq2TALKkuCujBnUTpr57wDO61y.jpg
                        vote_average: 8.2
                        vote_count: 8
                      - adult: false
                        backdrop_path: /etj8E2o0Bud0HkONVQPjyCkIvpv.jpg
                        first_air_date: '2022-08-21'
                        genre_ids:
                          - 10765
                          - 18
                          - 10759
                        id: 94997
                        name: House of the Dragon
                        origin_country:
                          - US
                        original_language: en
                        original_name: House of the Dragon
                        overview: >-
                          The Targaryen dynasty is at the absolute apex of its
                          power, with more than 15 dragons under their yoke.
                          Most empires crumble from such heights. In the case of
                          the Targaryens, their slow fall begins when King
                          Viserys breaks with a century of tradition by naming
                          his daughter Rhaenyra heir to the Iron Throne. But
                          when Viserys later fathers a son, the court is shocked
                          when Rhaenyra retains her status as his heir, and
                          seeds of division sow friction across the realm.
                        popularity: 341.675
                        poster_path: /t9XkeE7HzOsdQcDDDapDYh8Rrmt.jpg
                        vote_average: 8.4
                        vote_count: 5099
                      - adult: false
                        backdrop_path: /oGXuxNzrZ9QNuYYd7N4Zb9V6YKl.jpg
                        first_air_date: ''
                        genre_ids:
                          - 18
                          - 10765
                        id: 224372
                        name: 'A Knight of the Seven Kingdoms: The Hedge Knight'
                        origin_country:
                          - US
                        original_language: en
                        original_name: 'A Knight of the Seven Kingdoms: The Hedge Knight'
                        overview: >-
                          Set in an age when the Targaryen line still holds the
                          Iron Throne and the memory of the last dragon has not
                          yet passed from living memory, great destinies,
                          powerful foes and dangerous exploits all await these
                          improbable and incomparable friends.
                        popularity: 15.961
                        poster_path: /7Pb4gk51oUKWarOhvaSgf5RekIj.jpg
                        vote_average: 0
                        vote_count: 0
                    total_pages: 1
                    total_results: 4
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````