The Movie Database サポート

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

映画やテレビ番組が見つかりませんか?ログインして作成してください。

全般

s 検索バーに移動する
p プロファイルメニューを開く
esc 開いているウィンドウを閉じる
? キーボードショートカットウィンドウを開く

メディアのページ

b 戻る(または該当する場合は親に)
e 編集ページに行く

テレビ番組のシーズンのページ

(右矢印)次のシーズンに行く
(左矢印)前のシーズンに戻る

テレビ番組のエピソードのページ

(右矢印)次のエピソードに進む
(左矢印)前のエピソードに戻る

全ての画像のページ

a 画像追加ウィンドウを開く

全ての編集ページ

t 翻訳選択を開く
ctrl+ s フォームを送信する

ディスカッションのページ

n 新しいディスカッションを作成する
w 監視ステータスを切り替える
p 公開/非公開を切り替える
c 閉じる/開くを切り替える
a アクティビティを開く
r ディスカッションに返信
l 最後の返事に行く
ctrl+ enter メッセージを送信する
(右矢印)次のページ
(左矢印)前のページ

設定

このアイテムを評価したり、リストに追加したりしたいですか?

ログイン

メンバーではありませんか?

登録してコミュニティに参加