The Movie Database Support

Is there a possible issue with release_date in the API results?

With for example this one:

...the release date shows as March 19, 2019 (Premiere)

However, in the API results, it says:

"release_date": "2019-06-20",

Shouldn't this be:

"release_date": "2019-03-19",


The section with the Release Information says:

"releases": {
    "countries": [
        "certification": "",
        "iso_3166_1": "US",
        "primary": false,
        "release_date": "2019-03-19"
        "certification": "",
        "iso_3166_1": "RU",
        "primary": false,
        "release_date": "2019-06-20"

I can pull out the earliest date from the Release Information but I don't think that is the right way to do it.

8 replies (on page 1 of 1)

Jump to last post

Do not confuse:

primary_release_year or primary_release_date = The first premiere date in any country in the world.

release_date = The premiere date in a particular country.

The explanation is always clearer when you place here the request that was made.

In order for someone to help you with API Request questions, it is critical that you post here the API Request you are using.
Remember to replace your Key with [MY_KEY].

I don't see 'primary_release_date' anywhere in the API results. What section is that part of?

Here is an example:[MY_KEY]&language=en-US&append_to_response=recommendations,videos,keywords,similar,credits,content_ratings,releases,alternative_titles

Let me try to rephrase my question.

In the API result, I get "release_date": "2019-06-20",

When I look on the website ( it says under 'Release Information': March 19, 2019

Since March 19, 2019 is the correct date, where/how do I get that from the API results?

EDIT: To make it simpler, just the plain vanilla API call:[MY_KEY]

Why is it returning "release_date": "2019-06-20" and not "release_date": "2019-03-19"

I never saw it either. But I'm sure there are. :grin:
Look here in get/discover/movie:
There are these parameters: primary_release_year, primary_release_date.gte and primary_release_date.lte.
Every movie has a primary_release_year and a primary_release_date..
It is the oldest release date.
It is what determines the year that appears next to the movie title.

I know there's a kind of hierarchy between the premieres/releases.
In this hierarchy, I do not know the position of a Digital release.
And it looks like maybe that's the problem.
If the movie still does not have a premiere/release in the open room, a festival date will be used.
But as soon as an open room date appears, then that date will be considered primary.
Aliases, this ends up generating, in some cases, a divergence with the IMDB.

But I think Travis Bell can give a fuller answer.

Travis Bell ? HELP US !

Hi guys,

You can see the order in which primary release dates are chosen here in the Contribution Bible.

Based on the current logic and given the data available, the 2019-06-20 is correct.


Sorry for opening this one again but I'm still struggling to get the same release as displayed on the TMDB pages.

For example, this page nicely shows June 23, 2019 as the release date.

However, the API call to[MY_KEY] returns "release_date": "2019-11-07"

If I add &append_to_response=releases to figure out the right release date myself, I see the dates:

"releases": {
    "countries": [
        "certification": "",
        "iso_3166_1": "GB",
        "primary": false,
        "release_date": "2019-06-23"
        "certification": "R18+",
        "iso_3166_1": "AU",
        "primary": false,
        "release_date": "2019-11-07"

But I know I cannot simply pick the oldest one because I the bible says:

The primary release date used on TMDb is automatically calculated by looking for the first release that meets the following criteria in this order:

1: A "limited" or "theatrical" release
2: A "premiere" release
3: Any other release (digital, physical or TV)

...however, that information is missing from the API results.

So... how can I pick the release date as shown on ?

(and.. shouldn't that date (2019-06-23) be in the main "release_date": in the first place?)

Hi @FabioL,

There is currently no way to get the same regional release date via the get details method on the API. The website is using your region to query the correct date. Having said that, you are querying a very old and now deprecated API in releases and that method doesn't contain the release type information at all. /releases was deprecated in early 2017.

You should query release_dates instead, and then you can use your own logic to pick the best date that suits your needs. You can read more about this here.

Oh wow. release_dates That one has the info I was looking for. Thanks!!

No problem!


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