I know that if I want the shows that have started on a specific year, I should use first_air_date_year.
But as I see, year parameter seem has bug, it has no effect as my title said: "Year parameter has no effect in https://api.themoviedb.org/3/search/tv"
Somewhere along the way, year searches got mapped to first_air_date_year internally. A year search is supposed to mimic the behaviour on discover, which is to search all episode air dates. This has been corrected.
A valid year query is any number larger than 1000, and smaller than 9999. Using 1000 as a test value would be equivalent as not entering one at all.
The fix for the first issue has been deployed, and you'll now see searches like this working correctly:
Reply by ntrnghia
on January 22, 2024 at 10:34 PM
Why my discussion close?
Reply by superboy97
on January 23, 2024 at 12:01 AM
If you want help about a query, you need to provide the complete query you have sent as well as the supposed wrong answer you have got.
Reply by ntrnghia
on January 23, 2024 at 12:19 AM
So "https://api.themoviedb.org/3/search/tv?query=My%20boss&include_adult=false&language=en-US&page=1&year=2024" give the same results as "https://api.themoviedb.org/3/search/tv?query=My%20boss&include_adult=false&language=en-US&page=1&year=2020", and the results contain dramas in any year.
Reply by superboy97
on January 23, 2024 at 12:46 AM
With this query, you will get all shows that are still in progress in the indicated year.
If you want the shows that have started on a specif year, you should use "first_air_date_year" instead of "year".
Reply by ntrnghia
on January 23, 2024 at 1:04 AM
Even if I use "year=1000", I still get the same results.
Reply by superboy97
on January 23, 2024 at 1:11 AM
As long as you didn't give us the exact answer you got, as asked above, we can't answer you precisely.
Reply by ntrnghia
on January 23, 2024 at 1:15 AM
"https://api.themoviedb.org/3/search/tv?query=My%20boss&include_adult=false&language=en-US&page=1&year=1000" still give me the same results with any year. No drama in the list still in progress in year 1000.
Reply by Travis Bell
on January 23, 2024 at 1:18 AM
Reply by ntrnghia
on January 23, 2024 at 1:20 AM
I know that if I want the shows that have started on a specific year, I should use first_air_date_year. But as I see, year parameter seem has bug, it has no effect as my title said: "Year parameter has no effect in https://api.themoviedb.org/3/search/tv"
Reply by Travis Bell
on January 24, 2024 at 3:11 PM
There was a few things that went wrong here:
year
searches got mapped tofirst_air_date_year
internally. Ayear
search is supposed to mimic the behaviour on discover, which is to search all episode air dates. This has been corrected.The fix for the first issue has been deployed, and you'll now see searches like this working correctly:
But please note, a lot of these pages are cached so you will have to wait up to ~8 hours for everything to purge.
Reply by ntrnghia
on January 24, 2024 at 4:49 PM
I see it works now.
So to summarize:
Reply by Travis Bell
on January 24, 2024 at 4:57 PM
No. It's extracted from all of the episode air dates.
first_air_date_year
is extracted from the s1e1 air date, ie. when it premiered.No.
year
is extracted from every release date.primary_release_year
would be what to use if all you want to look at is the primary release date.Reply by superboy97
on January 24, 2024 at 4:57 PM
To summarize:
Reply by ntrnghia
on January 24, 2024 at 6:50 PM
Thank you guys, I totally understand now. Thanks for support.