Hi Mikez,

I've created a new ticket for this request here. I'm not sure when I will get to it but it's a good filter to add.

Cheers.

Saw that you just added air_date filters. That's even better. Thank you and keep up the good work! :)

Hi Mikez,

Perfect, no worries!

@travisbell said:

Hi Mikez,

I've created a new ticket for this request here. I'm not sure when I will get to it but it's a good filter to add.

Cheers.

Hi,

It is a useful filter. Can we expect it anytime soon?

@shahood said: Hi,
It is a useful filter.
Can we expect it anytime soon?

I believe it is already implemented.
Type and Status Filters for Movie and TV Show

TV SHOW - Type

ID  Type
0   Documentary
1   News
2   Miniseries
3   Reality
4   Scripted
5   Talk Show
6   Video

In Discover API use &with_type
Source:
Forum https://www.themoviedb.org/talk/5e1a60f7459ad6001435e0ae#6196d75e9512e1002a0020ac
Trello https://trello.com/c/Op5LGPeh/63-add-show-type-as-a-tv-discover-filter
Bible https://www.themoviedb.org/bible/tv/59f73eb49251416e7100001f#59f7403f9251416e7100002a

TV SHOW - Status

ID  Status
0   Returning Series
1   Planned
2   In Production
3   Ended
4   Canceled
5   Pilot

In Discover API use &with_status
Source:
Forum https://www.themoviedb.org/talk/6685c10585e1cbe90c4a5fe0#6686cbdea1784ec9b1334d0f
Trello https://trello.com/c/0EN8qEVX/117-add-tv-show-status-field-to-discover
Bible https://www.themoviedb.org/bible/tv/59f73eb49251416e7100001f#59f7403f9251416e7100002b

MOVIES - Release Type

ID  Release Type
1   Premiere
2   Theatrical (limited)
3   Theatrical
4   Digital
5   Physical
6   TV

In Discover API use &with_release_type
Source:
DOCs https://developer.themoviedb.org/docs/region-support
Trello https://trello.com/c/bpPVVwUr/69-support-and-queries-on-withreleasetype
Bible https://www.themoviedb.org/bible/movie/59f3b16d9251414f20000009#59f73d3c9251416e71000013

MOVIES - Status

ID  Status
0   Rumored
1   Planned
2   In Production
3   Post Production
4   Released
5   Canceled

I believe this feature has not yet been implemented in Discovery.
In Discover API use &with_status
Source:
Forum https://www.themoviedb.org/talk/6685c10585e1cbe90c4a5fe0#6686d1756a0e4f721e1be5d6
Trello https://trello.com/c/nPA8zE8k/146-add-a-withstatus-filter-to-movie-discover
Bible https://www.themoviedb.org/bible/movie/59f3b16d9251414f20000001#59f73b759251416e71000003
Forum https://www.themoviedb.org/talk/6685c10585e1cbe90c4a5fe0#6686da2bdc7a9accc91a712f

@ticao2 said:

TMDb MOVIES

*Movie Status*  (with_release_type string)  
ID    Status
0 Rumored
1 Planned
2 In Production
3 Post Production
4 Released
5 Canceled

Firstly, are you sure that the values are from 0-5, because the API reference says that the possible values are from 1-6?

Secondly, I'm trying the following query but no matter what value I give to with_release_type, the total number of results remains the same:

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]®ion=US&language=en&with_original_language=en&sort_by=popularity.desc&page=1&primary_release_date.gte=2025-05-04&primary_release_date.lte=2026-05-03&with_release_type=4

Can you please tell me what I'm doing wrong?

Hi @shahood, you can't use primary release dates and release types together. If you want to use release type, you have to switch to use plain release dates.

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]&region=US&language=en-US&with_original_language=en&sort_by=popularity.desc&page=1&release_date.gte=2025-05-04&release_date.lte=2026-05-03&with_release_type=4

@travisbell said:

Hi @shahood, you can't use primary release dates and release types together. If you want to use release type, you have to switch to use plain release dates.

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]®ion=US&language=en-US&with_original_language=en&sort_by=popularity.desc&page=1&release_date.gte=2025-05-04&release_date.lte=2026-05-03&with_release_type=4

I want to query for movies that are being released in the next one year and have a type of Post Production. I have tried the following query with both 3 and 4 release_type but it is returning movies with the status Released instead of Post Production.

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]®ion=US&language=en&with_original_language=en&sort_by=popularity.desc&page=1&release_date.gte=2025-05-04&release_date.lte=2026-05-03&with_release_type=3

I also tried removing the release dates from the query thinking that if a movie is with Post Production status, its release date should already be in the future. However, the result showed that with_release_type is not working at all without the use of release_date parameter:

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]®ion=US&language=en&with_original_language=en&sort_by=popularity.desc&page=1&with_release_type=3

@shahood said:

@ticao2 said:

TMDb MOVIES

*Movie Status*  (with_release_type string)  
ID  Status
0   Rumored
1   Planned
2   In Production
3   Post Production
4   Released
5   Canceled

Firstly, are you sure that the values are from 0-5, because the API reference says that the possible values are from 1-6?

I made a mistake.
In Movie I mixed up and inverted Type with Status.
And I added Movie Type.
I made the correction in my comment.
Tell me here if it was understandable.

Secondly, I'm trying the following query but no matter what value I give to with_release_type, the total number of results remains the same:

https://api.themoviedb.org/3/discover/movie?api_key=[API_KEY]®ion=US&language=en&with_original_language=en&sort_by=popularity.desc&page=1&primary_release_date.gte=2025-05-04&primary_release_date.lte=2026-05-03&with_release_type=4

Can you please tell me what I'm doing wrong?

Follow the instructions in Travis Bell's comment.

I think there's some confusion about two different filters. with_release_type maps to the release types like premiere, theatrical, digital, etc.

If you want to filter by movie status (released, in production, post production, etc.), you can't. That filter does not exist yet. We have an open ticket for that here.

@travisbell said:

I think there's some confusion about two different filters. with_release_type maps to the release types like premiere, theatrical, digital, etc.

If you want to filter by movie status (released, in production, post production, etc.), you can't. That filter does not exist yet. We have an open ticket for that here.

Yeah a whole lot of confusion.

Kindly make it available sooner than later. It would prove to be a useful filter.

Thanks!

Type and Status for Movie and TV Show

I believe "MOVIE Status" has not yet been implemented in API Discover.
2025-05-05