The Movie Database Support

Strictly speaking in an API Search query, what is the difference between the "year" and "primary_release_year" parameters... What are their definitions? So when would one be used over the other, if not both? I suppose to answer this question we would need to know which was being queried, but not id be in control of that which furthers my question how to use these. I did see the General note in "Editing Movies"

_"Release Dates

The primary release date, if set, is used as the year you will see throughout the site when looking at a movie (page titles, movie summary in lists, etc...) If a primary release data isn't set, we look for the U.S. date next. In the even that a U.S. date hasn't been added, we simply default to the first release entry by date.

If you see a '1900' referenced on a movie, that means that no release date has been added. Head in and add one."__

But that doesn't exactly answer my question.

Perhaps if i actually knew more about movies it would, but i suppose i don't...


1 reply (on page 1 of 1)

Jump to last post

Hi @axa,

By using the year filter, you are using all of the releases dates that have been added to a movie to search for information about. This means you're including theatrical release dates as well as digital and physical releases. By using the primary_release_year, you are only only using the single release date that we have added as the primary release.

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


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

Want to rate or add this item to a list?