The Movie Database Support
Support → API Support
Identifying from the API whether or not a movie or TV show is rateable?
posted by FlixDBSTAFFMOD on люты 9, 2024 at 9:19 AM
What is the best way of identifying whether a movie or tv show is rateable? For instance, upcoming movies or TV shows should not be ratable. I can see the API allows you to rate it, but it doesn't take effect (from what I can see).
If a movie has not been released, its status property is not "Released". Should I be using that? And if so, what about TV shows?
Or is there another approach, like looking at the release date?
Reply by Travis Bell
on люты 9, 2024 at 12:01 PM
Hi @FlixDB,
Items become rateable 7 days before their premiere date. Until then, ratings are not accepted.
Reply by FlixDB
on люты 9, 2024 at 12:13 PM
Hi @travisbell ,
Thanks for getting back to me.
From the API's..i.e. https://developer.themoviedb.org/reference/movie-details or https://developer.themoviedb.org/reference/tv-series-details
What property or properties (or other API) can I use to identify if it's rateable? Are you saying we just need to look at the release date, and it's rateable 7 days prior to that date? Is this what the TMDB website does? or is there anything else that is more efficient?
Reply by Travis Bell
on люты 9, 2024 at 12:17 PM
In essence, yes. We look for the earliest release date and if it's 7 or less days from now, it's accepted.
For movies, you can use the /release_dates method. For TV, it's either the premiere (first air date) which is the air date of season 1, episode 1, or for TV episodes, simply the air date.