The Movie Database Support

As mentioned in the Advanced Filtering description of discover/tv,

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It's important to note the order of the release types that are used. Specifying 2|3 would return the limited theatrical release date as opposed to 3|2 which would return the theatrical date.

However, there is no region parameter present in query parameters for discover/tv. Does this region mentioned in the description pertains to the watch_region?

For comparison,

怀discover/movie: has region and watch_region

怀discover/tv: has watch_region only

Both Advanced Filtering description are similar so that's where I would like to clarify.

Thanks!

6 replies (on page 1 of 1)

Jump to last post

@war.ren said:
Is there a region query parameter in discover/tv?
As mentioned in the Advanced Filtering description of discover/tv,

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It's important to note the order of the release types that are used. Specifying 2|3 would return the limited theatrical release date as opposed to 3|2 which would return the theatrical date.

However, there is no region parameter present in query parameters for discover/tv.
Does this region mentioned in the description pertains to the watch_region?**
For comparison,
怀discover/movie: has region and watch_region
怀discover/tv: has watch_region only

Both Advanced Filtering description are similar so that's where I would like to clarify.
Thanks!

For Movies, using region is useful to know if it is showing in cinemas in the region and other data for your country.
"watch_region" is only valid for what is available on networks, sales, rentals, etc...
This is the data provided by JustWatch.
HBO, Prime, Apple TV, Netflix, etc...

It's not exactly the same but it might help you.
It is not yet documented.
https://www.themoviedb.org/talk/5427067ac3a3680b1b000472#5fb6ead0b76cbb003e4a1172
https://trello.com/c/T9MhzW68/49-add-production-countries-to-tv-series-response
"&with_origin_country="
Example with TV.

https://api.themoviedb.org/3/discover/tv?api_key=THE_KEY&with_origin_country=IN

Just a few clarifications, indeed, like @ticao2 said, there is no such thing as regions on TV. region is designed as a way to filter release date information and TV does not have more than 1 release date per country or network, so it's not applicable.

with_origin_country is documented, and can be used to filter the origin of a TV show. It doesn't really have anything to do with where a TV show aired though, since a TV show can air all over the world at any time on any network or streaming provider. But ultimately, it just depends what you're actually trying to filter against.

@travisbell said:

Just a few clarifications, indeed, like @ticao2 said, there is no such thing as regions on TV. region is designed as a way to filter release date information and TV does not have more than 1 release date per country or network, so it's not applicable.

with_origin_country is documented, and can be used to filter the origin of a TV show. It doesn't really have anything to do with where a TV show aired though, since a TV show can air all over the world at any time on any network or streaming provider. But ultimately, it just depends what you're actually trying to filter against.

Hi there!

I don't fully understand what I marked as bold characters. Maybe I'm confusing some concepts but I can provide examples:

  • Naruto seems to be originally first aired on Japan in 2002 TMDB details
  • I know for certain that Naruto first aired around end of 2006, beginning on 2007 in Spain, on public TV networks
  • More recently, Naruto was going back and forth between providers such as Netflix or Amazon Prime Video, being available under certain time windows

Screen capture of Naruto being dropped from Netflix by October 31st of 2022

I can see that a given tv show can be aired or released in multiple dates in certain regions/countries, much as any movie can do.

So the question may rise again, is there any options for us to discover a tv serie in a time window (air date gte or lte) for a given region/country?

@Julio@Mindden, the part you highlighted is to do with TMDB data. On TMDB, we do not have any concept of multi region releases for TV. The data we have for TV release dates are the dates of the original air dates (as defined in the contribution bible.)

Thank you for your response, @travisbell.

Reading again the bible, in the following sentence:

"We currently only support the original air dates on the original network. "

I suppose that the fact of air dates not being related to countries/regions is included there.

Either way, I take this opportunity to thank you all for your work in the incredible API.

You got it!

Thanks for the kind words. blush

Can't find a movie or TV show? Login to create it.

Global

s focus the search bar
p open profile menu
esc close an open window
? open keyboard shortcut window

On media pages

b go back (or to parent when applicable)
e go to edit page

On TV season pages

(right arrow) go to next season
(left arrow) go to previous season

On TV episode pages

(right arrow) go to next episode
(left arrow) go to previous episode

On all image pages

a open add image window

On all edit pages

t open translation selector
ctrl+ s submit form

On discussion pages

n create new discussion
w toggle watching status
p toggle public/private
c toggle close/open
a open activity
r reply to discussion
l go to last reply
ctrl+ enter submit your message
(right arrow) next page
(left arrow) previous page

Settings

Want to rate or add this item to a list?

Login