The Movie Database Support
Support → API Support
TV API Preview
posted by Travis BellSTAFFMOD on October 24, 2013 at 2:15 PM
Hey guys,
I know a lot of you have been waiting for this so here it is, the TV API.
We currently have 17 methods available:
GET '/3/tv/:id'
GET '/3/tv/:id/credits'
GET '/3/tv/:id/external_ids'
GET '/3/tv/:id/images'
GET '/3/tv/:id/translations'
GET '/3/tv/:id/season/:season_number'
GET '/3/tv/:id/season/:season_number/credits'
GET '/3/tv/:id/season/:season_number/external_ids'
GET '/3/tv/:id/season/:season_number/images'
GET '/3/tv/:id/season/:season_number/episode/:episode_number'
GET '/3/tv/:id/season/:season_number/episode/:episode_number/credits'
GET '/3/tv/:id/season/:season_number/episode/:episode_number/external_ids'
GET '/3/tv/:id/season/:season_number/episode/:episode_number/images'
GET '/3/tv/on_the_air'
GET '/3/tv/top_rated'
GET '/3/tv/popular'
GET '/3/search/tv'
GET '/3/discover/tv'
And 3 new person credit methods to support TV and external IDs:
GET '/3/person/:id/movie_credits'
GET '/3/person/:id/tv_credits'
GET '/3/person/:id/combined_credits'
GET '/3/person/:id/external_ids'
And also new credit, find and network namespace:
GET '/3/credit/:id'
GET '/3/find/:id'
GET '/3/network/:id'
Functionality wise, they work almost identical to movies or the way you expect things to work on v3. The most notable thing missing right now is getting to the TV credits from the person side of things. I'll be working on that this week.
Understandably, this is a preview release and should be considered a risk. Some data could change depending on the feedback I get and if you roll this out publicly you are assuming that risk. I don't expect it to be like this for long, maybe a few weeks. I'll let everyone know when the design is final.
Now go ahead everyone, test!
Open Tickets
- LH-298 - Create the method to list TV genres
Resolved Tickets
-
LH-296- Link up TV credits on people -
LH-292- Create a tv season credits method -
LH-300- Ensure 404 items get a proper not found response -
LH-302- Rename sort_order to order to match the movie credit order field -
LH-304- Rename the TV character_name field to character to keep it consistent with movies -
LH-309- Create the /tv/popular method -
LH-310- Create the /tv/top-rated method -
LH-294- Create the /discover/tv method -
LH-295- Create the /network/:id method -
LH-311- Create a /tv/:id/translations method -
LH-301- Search for TvSeries by an external id -
LH-312- Create the /tv/on_the_air method -
LH-313- Create the /tv/today method -
LH-297- Hook up the change methods to TV
Reply by bmbrina
on July 1, 2015 at 3:41 PM
Hi, I was wondering if it is possible to select TV Shows based on their genre?
Thanks!
Reply by Travis Bell
on July 1, 2015 at 4:40 PM
Hi,
Yes, you use the /discover/tv method to search by genres. Check the docs for the full details.
http://docs.themoviedb.apiary.io/#reference/discover/discovertv
Reply by Inmatrix
on December 16, 2015 at 9:42 AM
What about TV shows that use a release date instead of season/episode, For example, "The Daily Show", is it possible to do an episode search by release date?
Reply by Travis Bell
on December 18, 2015 at 11:12 AM
Hi Inmatrix,
You can use /discover/tv and the
air_date.gte/air_date.ltefilters to search for episodes by their air date. Is that what you are looking for?Reply by Inmatrix
on December 18, 2015 at 3:20 PM
Hi Travis, No, this isn't what I meant, what I meant was something like: GET '/3/tv/:id/year/:year_number/month/:month_number/day/:day_number'
Where I specify a TV show's ID and a given air date and it will return the information.
Reply by Travis Bell
on December 21, 2015 at 11:24 AM
Hi Inmatrix,
Ah, I see. No, it's unlikely we'll support this anytime soon. I'm not saying a firm no, but adding something like this would be very low priority when I have so many other things to do ;)
Reply by jabedbhuiyan
on January 26, 2016 at 12:41 PM
is it possible to get season and episode wise result for tv series?
Something like this
http://api.themoviedb.org/3/search/en/Big bang theory?api_key=#&seasion=4&episode=3&external_source=freebase_id
Reply by Travis Bell
on January 26, 2016 at 12:46 PM
Hi jabedbhuiyan,
I might not be totally understanding the question but is this what you mean?
1418 being the ID of "The Big Band Theory" which you can get by doing a search:
Cheers.
Reply by jabedbhuiyan
on January 26, 2016 at 1:06 PM
thanks a lot. i want exactly this! Thank you bro :)
Reply by p3lim
on June 23, 2016 at 9:39 AM
Would love to see support for lists.
Reply by Travis Bell
on June 23, 2016 at 10:43 AM
@p3lim
It's the very next feature I'm working on :D Lists are getting torn down and completely rebuilt, the new lists will support both media types.