> ## Documentation Index > Fetch the complete documentation index at: https://emiloju.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Discover TV shows > This endpoint is used to find TV shows using over 30 filters and sort options. ## OpenAPI ````yaml api-reference/openapi.yaml get /3/discover/tv openapi: 3.0.3 info: title: Endpoints description: This section contains all the endpoints used in the documentation. version: 1.0.0 contact: {} servers: - url: https://api.themoviedb.org security: - bearerAuth: [] tags: - name: Authentication description: This section contains all endpoints used for authentication - name: Accounts description: This section contains account-specific endpoints. - name: Favorites description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows, episodes to favorites, and also to get a list of favorites for the account. - name: Movies description: >- This section contains an endpoint to add a movie to favorites, and another to get a list of favorite movies for a TMDB account. - name: TV shows description: >- This section contains an endpoint to get the favorite TV shows for an account. - name: Watchlist description: >- This section contains all endpoints that allow a TMDB account to add movies, TV Shows to watchlist, and also to get a list of watchlist for the account. - name: Movies1 description: >- This section contains an endpoint that allows a TMDB account to add a movie to watchlist, and another to get the movies in a watchlist. - name: TV shows1 description: >- This section contains an endpoint used to get TV shows in an account's watchlist. - name: Ratings description: >- This section contains endpoints used to get all movies, TV Shows, and episodes rated by a TMDB account. - name: Movies12 description: >- This section contains an endpoint used to get a list of movies rated by a TMDB account. - name: TV shows12 description: >- This section contains an endpoint used to get a list of TV shows rated by a TMDB account. - name: Episodes description: >- This section contains an endpoint used to get a list of episodes rated by a TMDB account. - name: Lists description: Endpoints for a TMDB account lists. - name: Guest sessions description: This section contains all endpoints accessible by a guest session. - name: Movies description: For movies. - name: TV episodes description: >- This section contains all endpoints used to retrieve data for all TV episodes. - name: TV seasons description: >- This section contains all endpoints used to retrieve data for all TV seasons. - name: TV series description: >- This section contains all endpoints used to retrieve data for all TV series. - name: TV series lists description: This section contains all endpoints used to list TV series. - name: TV episode groups description: This section contains an endpoint used to retrieve data for TV episodes. - name: Watch providers description: Get available regions. - name: People description: About people lists. - name: Companies description: >- This section contains all endpoints used to retrieve data for supported companies. - name: Discover description: This section contains all endpoints used to discover movies and TV shows. - name: Recent changes description: >- This section contains all endpoints used to get recent changes in the TMDB database. - name: Credit description: This section contains an endpoint used to retrieve movie credits. - name: Certifications description: >- This section contains all endpoints used to get certification for movies and TV shows. - name: Collections description: This section contains all endpoints used to retrieve data for collections - name: Configuration description: >- This section contains all endpoints used to retrieve data on TMDB's configurations. - name: Find description: >- This section contains an endpoint used to search the TMDB database by External ID. - name: Genres description: This section contains endpoints related to genres. - name: Keywords description: >- This section contains an endpoint used to get keywords in the database by an ID. - name: Movie lists description: >- This section contains all endpoints used to retrieve movies by multiple search filters. - name: Networks description: For network endpoints. - name: Reviews description: For reviews endpoints. - name: Search description: For search endpoints. - name: Trending description: For trending videos. paths: /3/discover/tv: get: tags: - Discover summary: Discover TV shows description: >- This endpoint is used to find TV shows using over 30 filters and sort options. operationId: discoverTvShows parameters: - name: language in: query schema: type: string example: it description: The predominant language used in the movie - name: year in: query schema: type: string example: '2010' description: The TV show release year responses: '200': description: New Request headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=6819 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Sun, 08 Dec 2024 12:38:42 GMT ETag: schema: type: string example: W/"253ecbad54975d828d212c8752526a5d" 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 fa4c901415bf2d15a28f00ab0ba2e776.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: '-wOdZD3mhM9N4fP6AH9VKcAPeSVuqaHi9vMWbDE2nHXTUw-Gvu5fIQ==' X-Amz-Cf-Pop: schema: type: string example: LHR50-P2 X-Cache: schema: type: string example: Miss from cloudfront x-memc: schema: type: string example: HIT x-memc-age: schema: type: string example: '21341' x-memc-expires: schema: type: string example: '6819' x-memc-key: schema: type: string example: 5081815a53390c63decf3dbfa669985a 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 nullable: true example: /jWXrQstj7p3Wl5MfYWY6IHqRpDb.jpg first_air_date: type: string example: '1952-12-26' genre_ids: type: array items: type: number example: 10763 example: - 10763 id: type: number example: 94722 name: type: string example: Tagesschau origin_country: type: array items: type: string example: DE example: - DE original_language: type: string example: de original_name: type: string example: Tagesschau overview: type: string example: '' popularity: type: number example: 2724.22 poster_path: type: string example: /7dFZJ2ZJJdcmkp05B9NWlqTJ5tq.jpg vote_average: type: number example: 6.78 vote_count: type: number example: 232 example: - adult: false backdrop_path: /jWXrQstj7p3Wl5MfYWY6IHqRpDb.jpg first_air_date: '1952-12-26' genre_ids: - 10763 id: 94722 name: Tagesschau origin_country: - DE original_language: de original_name: Tagesschau overview: '' popularity: 2724.22 poster_path: /7dFZJ2ZJJdcmkp05B9NWlqTJ5tq.jpg vote_average: 6.78 vote_count: 232 - adult: false backdrop_path: /9zIqN0oMmaeFvBlccgw80sWed7I.jpg first_air_date: '2007-09-10' genre_ids: - 10763 - 35 id: 13008 name: TMZ origin_country: - US original_language: en original_name: TMZ overview: '' popularity: 1383.107 poster_path: /ifFpUG51DJaQxwnZ35VwoGRFGGv.jpg vote_average: 4.308 vote_count: 13 - adult: false backdrop_path: /lmvsFQpAhx4k9dqKvOgb2B63MsC.jpg first_air_date: '2012-01-30' genre_ids: - 10763 - 10767 id: 113779 name: Hallo Hessen origin_country: - DE original_language: de original_name: Hallo Hessen overview: '' popularity: 1259.138 poster_path: /zRGme9GL0H5RmwzxKYzoXafcRDp.jpg vote_average: 7.125 vote_count: 4 - adult: false backdrop_path: /vgeDRVpSUa4Hvovg4C6dgm4dfUW.jpg first_air_date: '2020-11-02' genre_ids: - 10766 - 18 id: 112470 name: Ici tout commence origin_country: - FR original_language: fr original_name: Ici tout commence overview: '' popularity: 1237.484 poster_path: /yuTHx38jpogXovMhqNatvozigMJ.jpg vote_average: 7.025 vote_count: 80 - adult: false backdrop_path: /xeJJZE8yC09lRbiV2f2hqURJmhd.jpg first_air_date: '2024-09-09' genre_ids: - 10766 - 18 - 9648 id: 237478 name: Mania de Você origin_country: - BR original_language: pt original_name: Mania de Você overview: '' popularity: 1199.633 poster_path: /xq1X6H8pupwx0jeZpu4Piq0V5uL.jpg vote_average: 6 vote_count: 5 - adult: false backdrop_path: /zSPvARNCFpZxmWjgJCsBu5PUlR9.jpg first_air_date: '2024-10-21' genre_ids: - 35 - 18 - 10751 - 10762 - 10759 id: 247885 name: Papás por Conveniencia origin_country: - MX - US original_language: en original_name: Papás por Conveniencia overview: '' popularity: 1191.673 poster_path: /y7yIu9PKx2WTphhYgbBq9C1RNzV.jpg vote_average: 7.923 vote_count: 26 - adult: false backdrop_path: /4i3iJepkqqH5JJgTNLJdi8ke6ir.jpg first_air_date: '2024-05-06' genre_ids: - 10766 id: 249010 name: Kelders van Geheime origin_country: - ZA original_language: af original_name: Kelders van Geheime overview: '' popularity: 1120.538 poster_path: /vf1I0G5jICTstI1EXxb9Oqq80TU.jpg vote_average: 6.182 vote_count: 11 - adult: false backdrop_path: /mLcD1v4sfoa1juOsBat7Vik7wEe.jpg first_air_date: '2024-03-18' genre_ids: - 10764 id: 248890 name: Ready Steady Cook South Africa origin_country: - ZA original_language: en original_name: Ready Steady Cook South Africa overview: '' popularity: 1116.691 poster_path: /30xX4IMbgnMbQwo76xM4BOSokZO.jpg vote_average: 2.929 vote_count: 7 - adult: false backdrop_path: /7ZBNbpkLhC2fS90j6onLS8qqfRX.jpg first_air_date: '2004-10-25' genre_ids: [] id: 4682 name: 'Strictly Come Dancing: It Takes Two' origin_country: - GB original_language: en original_name: 'Strictly Come Dancing: It Takes Two' overview: '' popularity: 1075.151 poster_path: /1UOKLsJ3bopZHg6ntRfmO4C5Gcm.jpg vote_average: 4.909 vote_count: 11 - adult: false backdrop_path: null first_air_date: '2024-10-14' genre_ids: [] id: 274136 name: Stardance XIII ...kolem dokola origin_country: - CZ original_language: cs original_name: Stardance XIII ...kolem dokola overview: '' popularity: 1040.911 poster_path: /iJPk8DSr2NVpfeFxembWxROqQNW.jpg vote_average: 6.333 vote_count: 3 - adult: false backdrop_path: /uNSfDU18aGkJTaWuJGQ1bI0hFvq.jpg first_air_date: '2024-11-17' genre_ids: - 10767 id: 275715 name: I'm a Celebrity... Unpacked origin_country: - GB original_language: en original_name: I'm a Celebrity... Unpacked overview: '' popularity: 1717.697 poster_path: /sY1x4nU5yGZ34E1Jew07aEhjPHK.jpg vote_average: 1 vote_count: 1 - adult: false backdrop_path: /4ErOWmDGyGk0qCK1J8blAoj1a7a.jpg first_air_date: '2024-06-18' genre_ids: - 18 id: 252373 name: A Promessa origin_country: - PT original_language: pt original_name: A Promessa overview: '' popularity: 983.017 poster_path: /uptgxt2apx5wwWItQzqL0HwhjZC.jpg vote_average: 6.5 vote_count: 11 - adult: false backdrop_path: null first_air_date: '2005-09-05' genre_ids: - 18 - 35 id: 36361 name: Ulice origin_country: - CZ original_language: cs original_name: Ulice overview: '' popularity: 928.532 poster_path: /gFEHva8Csx18hMGJJZ6gi4sFSKR.jpg vote_average: 4.6 vote_count: 30 - adult: false backdrop_path: /i8iqYtAy9qcO5RSrA1f6fY1n6SN.jpg first_air_date: '2015-11-16' genre_ids: - 10766 id: 235484 name: Suidooster origin_country: - ZA original_language: af original_name: Suidooster overview: '' popularity: 909.675 poster_path: /naCgSiacvV685kait6fBvhVhdce.jpg vote_average: 7.65 vote_count: 20 - adult: false backdrop_path: /ohJTnu93hJ0Uonl86Wn3mOSlWXN.jpg first_air_date: '2017-02-06' genre_ids: - 10751 - 35 - 18 id: 91759 name: 愛·回家之開心速遞 origin_country: - HK original_language: cn original_name: 愛·回家之開心速遞 overview: '' popularity: 1499.137 poster_path: /lgD4j9gUGmMckZpWWRJjorWqGVT.jpg vote_average: 5.35 vote_count: 40 - adult: false backdrop_path: /C0A0Ar8QTnST03sy816MxdUt3K.jpg first_air_date: '2010-11-22' genre_ids: - 10764 id: 60780 name: Four in a Bed origin_country: - GB original_language: en original_name: Four in a Bed overview: '' popularity: 892.234 poster_path: /nFzW9V9rjKQcsunNrjw1yPc2zT8.jpg vote_average: 6.2 vote_count: 16 - adult: false backdrop_path: /zk3UqXnnK7cpUv6LsD9DS8FtUxb.jpg first_air_date: '2024-09-02' genre_ids: - 18 - 10759 id: 256121 name: Lavender Fields origin_country: - PH original_language: tl original_name: Lavender Fields overview: '' popularity: 874.107 poster_path: /lphvsr062SlxWM6XegsV2dLGaiE.jpg vote_average: 8.2 vote_count: 4 - adult: false backdrop_path: /j5CR0gFPjwgmAXkV9HGaF4VMjIW.jpg first_air_date: '2024-09-30' genre_ids: - 10766 - 18 - 35 id: 257064 name: Volta por Cima origin_country: - BR original_language: pt original_name: Volta por Cima overview: '' popularity: 1441.818 poster_path: /nyN8R0P1Hqwq7ksJz4O2BIAUd4W.jpg vote_average: 6.4 vote_count: 9 - adult: false backdrop_path: /mu3lEhGovyhKHPJzb7HNYtZUCDT.jpg first_air_date: '2005-10-13' genre_ids: - 10766 id: 206559 name: Binnelanders origin_country: - ZA original_language: af original_name: Binnelanders overview: '' popularity: 859.37 poster_path: /3bzECfllho8PphdYujLUIuhncJD.jpg vote_average: 5.6 vote_count: 74 - adult: false backdrop_path: /tPLUHT2cQYJi66aSZZ1qrcu74Zq.jpg first_air_date: '2024-11-04' genre_ids: - 10766 - 18 id: 257048 name: Garota do Momento origin_country: - BR original_language: pt original_name: Garota do Momento overview: '' popularity: 1418.621 poster_path: /jFSkjQSZ5Td52igalpoTQRuHtk.jpg vote_average: 7.5 vote_count: 6 total_pages: type: number example: 9359 total_results: type: number example: 187163 examples: New Request: value: page: 1 results: - adult: false backdrop_path: /jWXrQstj7p3Wl5MfYWY6IHqRpDb.jpg first_air_date: '1952-12-26' genre_ids: - 10763 id: 94722 name: Tagesschau origin_country: - DE original_language: de original_name: Tagesschau overview: '' popularity: 2724.22 poster_path: /7dFZJ2ZJJdcmkp05B9NWlqTJ5tq.jpg vote_average: 6.78 vote_count: 232 - adult: false backdrop_path: /9zIqN0oMmaeFvBlccgw80sWed7I.jpg first_air_date: '2007-09-10' genre_ids: - 10763 - 35 id: 13008 name: TMZ origin_country: - US original_language: en original_name: TMZ overview: '' popularity: 1383.107 poster_path: /ifFpUG51DJaQxwnZ35VwoGRFGGv.jpg vote_average: 4.308 vote_count: 13 - adult: false backdrop_path: /lmvsFQpAhx4k9dqKvOgb2B63MsC.jpg first_air_date: '2012-01-30' genre_ids: - 10763 - 10767 id: 113779 name: Hallo Hessen origin_country: - DE original_language: de original_name: Hallo Hessen overview: '' popularity: 1259.138 poster_path: /zRGme9GL0H5RmwzxKYzoXafcRDp.jpg vote_average: 7.125 vote_count: 4 - adult: false backdrop_path: /vgeDRVpSUa4Hvovg4C6dgm4dfUW.jpg first_air_date: '2020-11-02' genre_ids: - 10766 - 18 id: 112470 name: Ici tout commence origin_country: - FR original_language: fr original_name: Ici tout commence overview: '' popularity: 1237.484 poster_path: /yuTHx38jpogXovMhqNatvozigMJ.jpg vote_average: 7.025 vote_count: 80 - adult: false backdrop_path: /xeJJZE8yC09lRbiV2f2hqURJmhd.jpg first_air_date: '2024-09-09' genre_ids: - 10766 - 18 - 9648 id: 237478 name: Mania de Você origin_country: - BR original_language: pt original_name: Mania de Você overview: '' popularity: 1199.633 poster_path: /xq1X6H8pupwx0jeZpu4Piq0V5uL.jpg vote_average: 6 vote_count: 5 - adult: false backdrop_path: /zSPvARNCFpZxmWjgJCsBu5PUlR9.jpg first_air_date: '2024-10-21' genre_ids: - 35 - 18 - 10751 - 10762 - 10759 id: 247885 name: Papás por Conveniencia origin_country: - MX - US original_language: en original_name: Papás por Conveniencia overview: '' popularity: 1191.673 poster_path: /y7yIu9PKx2WTphhYgbBq9C1RNzV.jpg vote_average: 7.923 vote_count: 26 - adult: false backdrop_path: /4i3iJepkqqH5JJgTNLJdi8ke6ir.jpg first_air_date: '2024-05-06' genre_ids: - 10766 id: 249010 name: Kelders van Geheime origin_country: - ZA original_language: af original_name: Kelders van Geheime overview: '' popularity: 1120.538 poster_path: /vf1I0G5jICTstI1EXxb9Oqq80TU.jpg vote_average: 6.182 vote_count: 11 - adult: false backdrop_path: /mLcD1v4sfoa1juOsBat7Vik7wEe.jpg first_air_date: '2024-03-18' genre_ids: - 10764 id: 248890 name: Ready Steady Cook South Africa origin_country: - ZA original_language: en original_name: Ready Steady Cook South Africa overview: '' popularity: 1116.691 poster_path: /30xX4IMbgnMbQwo76xM4BOSokZO.jpg vote_average: 2.929 vote_count: 7 - adult: false backdrop_path: /7ZBNbpkLhC2fS90j6onLS8qqfRX.jpg first_air_date: '2004-10-25' genre_ids: [] id: 4682 name: 'Strictly Come Dancing: It Takes Two' origin_country: - GB original_language: en original_name: 'Strictly Come Dancing: It Takes Two' overview: '' popularity: 1075.151 poster_path: /1UOKLsJ3bopZHg6ntRfmO4C5Gcm.jpg vote_average: 4.909 vote_count: 11 - adult: false backdrop_path: null first_air_date: '2024-10-14' genre_ids: [] id: 274136 name: Stardance XIII ...kolem dokola origin_country: - CZ original_language: cs original_name: Stardance XIII ...kolem dokola overview: '' popularity: 1040.911 poster_path: /iJPk8DSr2NVpfeFxembWxROqQNW.jpg vote_average: 6.333 vote_count: 3 - adult: false backdrop_path: /uNSfDU18aGkJTaWuJGQ1bI0hFvq.jpg first_air_date: '2024-11-17' genre_ids: - 10767 id: 275715 name: I'm a Celebrity... Unpacked origin_country: - GB original_language: en original_name: I'm a Celebrity... Unpacked overview: '' popularity: 1717.697 poster_path: /sY1x4nU5yGZ34E1Jew07aEhjPHK.jpg vote_average: 1 vote_count: 1 - adult: false backdrop_path: /4ErOWmDGyGk0qCK1J8blAoj1a7a.jpg first_air_date: '2024-06-18' genre_ids: - 18 id: 252373 name: A Promessa origin_country: - PT original_language: pt original_name: A Promessa overview: '' popularity: 983.017 poster_path: /uptgxt2apx5wwWItQzqL0HwhjZC.jpg vote_average: 6.5 vote_count: 11 - adult: false backdrop_path: null first_air_date: '2005-09-05' genre_ids: - 18 - 35 id: 36361 name: Ulice origin_country: - CZ original_language: cs original_name: Ulice overview: '' popularity: 928.532 poster_path: /gFEHva8Csx18hMGJJZ6gi4sFSKR.jpg vote_average: 4.6 vote_count: 30 - adult: false backdrop_path: /i8iqYtAy9qcO5RSrA1f6fY1n6SN.jpg first_air_date: '2015-11-16' genre_ids: - 10766 id: 235484 name: Suidooster origin_country: - ZA original_language: af original_name: Suidooster overview: '' popularity: 909.675 poster_path: /naCgSiacvV685kait6fBvhVhdce.jpg vote_average: 7.65 vote_count: 20 - adult: false backdrop_path: /ohJTnu93hJ0Uonl86Wn3mOSlWXN.jpg first_air_date: '2017-02-06' genre_ids: - 10751 - 35 - 18 id: 91759 name: 愛·回家之開心速遞 origin_country: - HK original_language: cn original_name: 愛·回家之開心速遞 overview: '' popularity: 1499.137 poster_path: /lgD4j9gUGmMckZpWWRJjorWqGVT.jpg vote_average: 5.35 vote_count: 40 - adult: false backdrop_path: /C0A0Ar8QTnST03sy816MxdUt3K.jpg first_air_date: '2010-11-22' genre_ids: - 10764 id: 60780 name: Four in a Bed origin_country: - GB original_language: en original_name: Four in a Bed overview: '' popularity: 892.234 poster_path: /nFzW9V9rjKQcsunNrjw1yPc2zT8.jpg vote_average: 6.2 vote_count: 16 - adult: false backdrop_path: /zk3UqXnnK7cpUv6LsD9DS8FtUxb.jpg first_air_date: '2024-09-02' genre_ids: - 18 - 10759 id: 256121 name: Lavender Fields origin_country: - PH original_language: tl original_name: Lavender Fields overview: '' popularity: 874.107 poster_path: /lphvsr062SlxWM6XegsV2dLGaiE.jpg vote_average: 8.2 vote_count: 4 - adult: false backdrop_path: /j5CR0gFPjwgmAXkV9HGaF4VMjIW.jpg first_air_date: '2024-09-30' genre_ids: - 10766 - 18 - 35 id: 257064 name: Volta por Cima origin_country: - BR original_language: pt original_name: Volta por Cima overview: '' popularity: 1441.818 poster_path: /nyN8R0P1Hqwq7ksJz4O2BIAUd4W.jpg vote_average: 6.4 vote_count: 9 - adult: false backdrop_path: /mu3lEhGovyhKHPJzb7HNYtZUCDT.jpg first_air_date: '2005-10-13' genre_ids: - 10766 id: 206559 name: Binnelanders origin_country: - ZA original_language: af original_name: Binnelanders overview: '' popularity: 859.37 poster_path: /3bzECfllho8PphdYujLUIuhncJD.jpg vote_average: 5.6 vote_count: 74 - adult: false backdrop_path: /tPLUHT2cQYJi66aSZZ1qrcu74Zq.jpg first_air_date: '2024-11-04' genre_ids: - 10766 - 18 id: 257048 name: Garota do Momento origin_country: - BR original_language: pt original_name: Garota do Momento overview: '' popularity: 1418.621 poster_path: /jFSkjQSZ5Td52igalpoTQRuHtk.jpg vote_average: 7.5 vote_count: 6 total_pages: 9359 total_results: 187163 components: securitySchemes: bearerAuth: type: http scheme: bearer ````