The Movie Database Support

https://api.themoviedb.org/3/discover/movie?region=US&primary_release_date.gte=2020-05-28&primary_release_date.lte=2020-05-28&include_adult=false&include_video=false&with_release_type=2|3&sort_by=popularity.desc&api_key=xxx

3 movies returned, 2 of them have a release date of 2020-05-28, as specified in the "primary_release_date.gte" and "primary_release_date.lte" params, but there is a 3rd movie included which has a release date in the future:

The SpongeBob Movie: Sponge on the Run ID: 400160 Release date: 2020-08-07

Any ideas why? ps, thanks for providing this awesome API :)

7 replies (on page 1 of 1)

Jump to last post

One of the release dates of the film is this:

UcrΓ’nia - 28/05/2020 Cinema

See here
https://www.themoviedb.org/movie/400160-the-spongebob-movie-sponge-on-the-run/edit?active_nav_item=release_information

In other words, Ukraine in 2020-05-28.
And it is this date that is being considered the World Release Date or Primary Release Date.

Interesting... I thought that by providing the "region" parameter, I would only get movies released in the US on the specified date?

Is there any way to achieve that? (only get movies released in the US on the specified date)

Thanks again

I think so.
If you don't use Primary Release Date.
If you use only Release Date I believe that you will only receive the date of the Region that you specified in the API Request.

@sammydigits said:

Interesting... I thought that by providing the "region" parameter, I would only get movies released in the US on the specified date?

You can't really mix primary and non primary requests. Using primary will negate any region query you're doing because there's no such thing as a "primary release per country". It's a single, per media date. Regular release date queries on the other hand, you're good to go. See below.

Is there any way to achieve that? (only get movies released in the US on the specified date)

Yes, something like this should do:

https://api.themoviedb.org/3/discover/movie?region=US&release_date.gte=2020-05-28&release_date.lte=2020-05-28&include_adult=false&include_video=false&with_release_type=2%7C3&sort_by=popularity.desc&api_key=xxx

Thank you both, switching to "release_date" certainly seemed to solve the issue.

Can you also please confirm the difference between the "limited theatrical release date" vs "theatrical date" as mentioned here in the docs:

"Specifying "2|3" would return the limited theatrical release date as opposed to "3|2" which would return the theatrical date."

Ideally I want a list of movies which are available on general nationwide release in theaters for today's date, so presumably "3|2" would be my best option?

Specifying 2 will always include the limited releases, so if you only want to include wide (nationwide) releases, you should only specify 3. If you specify both, the difference is which release it will show if both exist. 3|2 would default to wide release, while 2|3 would default to limited.

Perfect, nationwide is what I need. Thank you very much for providing this awesome API Travis!

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