TMDB Get Discover Tv

1 credits/call
ae_tmdb_get_discover_tv

Find TV shows by filtering and sorting based on criteria like air dates and genres.

Entertainment
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoSpecify which page to query.1
sort_byenum (first_air_date.asc | first_air_date.desc | name.asc | name.desc | original_name.asc | original_name.desc | popularity.asc | popularity.desc | vote_average.asc | vote_average.desc | vote_count.asc | vote_count.desc)NoChoose from one of the many available sort options.popularity.desc
languagestringNoSpecify a language to query translatable fields with.en-US
timezonestringNoUsed in conjunction with the release_type when using with_release_type. Set to something like PST for Pacific Standard Time.—
with_typestringNoFilter results to include only those TV shows with a specific type. Possible values are: [0, 1, 2, 3, 4, 5, 6].—
with_genresstringNoFilter results to include only those TV shows with specific genres. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.—
with_statusstringNoFilter results to include only those TV shows with a specific status. Possible values are: [0, 1, 2, 3, 4, 5].—
air_date.gtestringNoMinimum air date.—
air_date.ltestringNoMaximum air date.—
watch_regionstringNoAn ISO 3166-1 code to filter watch providers.—
include_adultbooleanNoWhether to include adult (pornography) content in the results.false
with_keywordsstringNoFilter results to include only those TV shows with specific keywords. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.—
with_networksintegerNoFilter results to include only those TV shows from specific networks.—
vote_count.gtenumberNoMinimum vote count.—
vote_count.ltenumberNoMaximum vote count.—
with_companiesstringNoFilter results to include only those TV shows produced by specific companies. Comma separated indicates an 'AND' query, while a pipe (|) separated value indicates an 'OR'.—
without_genresstringNoFilter results to exclude those TV shows with specific genres.—
vote_average.gtenumberNoMinimum vote average.—
vote_average.ltenumberNoMaximum vote average.—
with_runtime.gteintegerNoFilter results to include only those TV shows with a runtime greater than or equal to a value.—
with_runtime.lteintegerNoFilter results to include only those TV shows with a runtime less than or equal to a value.—
without_keywordsstringNoFilter results to exclude those TV shows with specific keywords.—
without_companiesstringNoFilter results to exclude those TV shows produced by specific companies.—
first_air_date.gtestringNoMinimum first air date.—
first_air_date.ltestringNoMaximum first air date.—
first_air_date_yearintegerNoFilter by the year of the first air date.—
with_origin_countrystringNoFilter results to include only those TV shows with a specific origin country.—
with_watch_providersstringNoFilter results to include only those TV shows with specific watch providers.—
screened_theatricallybooleanNoFilter results to include only those TV shows that have been screened theatrically.—
with_original_languagestringNoFilter results to include only those TV shows with a specific original language.—
without_watch_providersstringNoFilter results to exclude those TV shows with specific watch providers.—
include_null_first_air_datesbooleanNoWhether to include shows with null first air dates.false
with_watch_monetization_typesstringNoFilter results to include only those TV shows with specific watch monetization types. Possible values are: [flatrate, free, ads, rent, buy].—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tmdb_get_discover_tv' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "include_adult": false,
    "include_null_first_air_dates": false,
    "language": "en-US",
    "page": 1,
    "sort_by": "popularity.desc"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/dyFTt1a9ZpFdKE96kPlE9fQvXOJ.jpg",
      "first_air_date": "2017-02-20",
      "genre_ids": [
        10751
      ],
      "id": 91759,
      "origin_country": [
        "HK"
      ]
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.