Sign in
search

Discover TV shows

Returns a list of TV shows in a JSON object.

get/discover/tv

Request

  • Base URL: http://localhost:5055/api/v1
  • URL: http://localhost:5055/api/v1/discover/tv
  • Auth: one of:
    • API key in cookie connect.sid
    • API key in header X-Api-Key

Query parameters

pagenumber
Example:1
languagestring
Example:en
genrestring
networknumber
Example:1
keywordsstring
Example:1,2
excludeKeywordsstring
Example:3,4

Comma-separated list of keyword IDs to exclude from results

sortBystring
Example:popularity.desc
firstAirDateGtestring
Example:2022-01-01
firstAirDateLtestring
Example:2023-01-01
withRuntimeGtenumber
Example:60
withRuntimeLtenumber
Example:120
voteAverageGtenumber
Example:7
voteAverageLtenumber
Example:10
voteCountGtenumber
Example:7
voteCountLtenumber
Example:10
watchRegionstring
Example:US
watchProvidersstring
Example:8|9
statusstring
Example:3|4
certificationstring
Example:TV-14

Exact certification to filter by (used when certificationMode is 'exact')

certificationGtestring
Example:TV-PG

Minimum certification to filter by (used when certificationMode is 'range')

certificationLtestring
Example:TV-MA

Maximum certification to filter by (used when certificationMode is 'range')

certificationCountrystring
Example:US

Country code for the certification system (e.g., US, GB, CA)

certificationMode'exact' | 'range'
Example:exact

Determines whether to use exact certification matching or a certification range (internal use only, not sent to TMDB API)

Response

Results

pagenumber
totalPagesnumber
totalResultsnumber

Example response

{
  "page": 1,
  "totalPages": 20,
  "totalResults": 200,
  "results": [
    {
      "id": 1234,
      "popularity": 10,
      "overview": "Overview of the movie",
      "originalLanguage": "en",
      "name": "TV Show Name",
      "originalName": "Original TV Show Name",
      "mediaInfo": {
        "requests": [
          {
            "id": 123,
            "createdAt": "2020-09-12T10:00:27.000Z",
            "updatedAt": "2020-09-12T10:00:27.000Z",
            "requestedBy": {
              "id": 1,
              "email": "hey@itsme.com",
              "userType": 1,
              "createdAt": "2020-09-02T05:02:23.000Z",
              "updatedAt": "2020-09-02T05:02:23.000Z",
              "requestCount": 5
            },
            "modifiedBy": {
              "id": 1,
              "email": "hey@itsme.com",
              "userType": 1,
              "createdAt": "2020-09-02T05:02:23.000Z",
              "updatedAt": "2020-09-02T05:02:23.000Z",
              "requestCount": 5
            }
          }
        ],
        "createdAt": "2020-09-12T10:00:27.000Z",
        "updatedAt": "2020-09-12T10:00:27.000Z"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 21 revisions of this API.