The Movie Database Support
Support → API Laguntza
TV API Preview
Travis BellSTAFFMOD erabiltzaileak Urria 24, 2013 egunean 2:15 PM(e)tan bidalia
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
Koen Klaren Erabiltzailearen Erantzuna
Urria 24, 2013 egunean 4:52 PM(e)tan
Just browsing through the documentation at the moment. You probably have most of this on your todo list already, but here are some things I noticed anyways. You can get the credits for series and episodes, but not for seasons, which is possible on the site. TV information includes network references, but there are no methods to get more information on these. Besides TV-specific methods missing from the "person side of things", they're also missing from changes, genres, discover etc.
One more thing on the API documentation in general. Some properties are not fully explained,
belongs_to_collectionis shown as null in an example and someone (like me) might assume it'll return the collection id, but it actually returns an object. Also, not all possible values for properties likestatuson TV series are listed, only "Ended". It might be useful for developers if they knew what to expect of some properties :)Anyways, I love the idea of having a central API for my media center!
Travis Bell Erabiltzailearen Erantzuna
Urria 24, 2013 egunean 5:06 PM(e)tan
The
castandcrewarrays on episodes hold the season level cast and crew info but it wouldn't hurt to duplicate the data on a season level. Ticket for that is here.Each one of those will be hashed out over time. That's why this is just a preview. It's enough to get started and dip your feet in to see if anything really obvious is missing.
MovieRollApp Erabiltzailearen Erantzuna
Urria 25, 2013 egunean 12:19 AM(e)tan
This is great, thank you!
Stuart Boston Erabiltzailearen Erantzuna
Urria 25, 2013 egunean 10:27 AM(e)tan
Excellent, I shall have a go at implementing the methods over the weekend and see what issues are thrown up :)
Stuart Boston Erabiltzailearen Erantzuna
Urria 30, 2013 egunean 11:59 AM(e)tan
Appreciate that this is still in beta, but are you planning on adding the paging and other features seen with the movie methods? Example, calling
gets you
<h1>Not found</h1>rather than a nice status code. Same for most of the other methods too.veinfeldt Erabiltzailearen Erantzuna
Urria 30, 2013 egunean 3:09 PM(e)tan
Do you have any plans on allowing indexing series via its imdb id like you have for movies? Ex: /3/tv/tt0903747 to retrieve info on Breaking Bad?
In any case - great work! :)
Travis Bell Erabiltzailearen Erantzuna
Urria 30, 2013 egunean 6:01 PM(e)tan
Yes, and most should already (some I just tested look good) but it does indeed look like some were missed. Probably especially down into the nested episode level. I've created a new ticket.
I do but it probably won't work the same way since we support multiple external ids on TV objects. I've created a new ticket for this here but am not sure when I'll be looking at it. In the grand scheme of things it's lower on my priority list than some other features.
Cheers.
Travis Bell Erabiltzailearen Erantzuna
Urria 31, 2013 egunean 3:34 PM(e)tan
LH-292 and LH-302 were just pushed live. LH-302 is a breaking change so make sure to update your code!
Stuart Boston Erabiltzailearen Erantzuna
Urria 31, 2013 egunean 3:42 PM(e)tan
If you are naming fields, you might also consider "character_name" -> "character" in the episode/credits
Travis Bell Erabiltzailearen Erantzuna
Urria 31, 2013 egunean 6:16 PM(e)tan
Done and deployed. LH-304.
ddelec24 Erabiltzailearen Erantzuna
Azaroa 4, 2013 egunean 7:27 AM(e)tan
Do you plan to create a method "GET '/3/tv/:id/changes' like it exists with movie? Thank you!
Travis Bell Erabiltzailearen Erantzuna
Azaroa 4, 2013 egunean 9:50 AM(e)tan
cough, points to the list of open tickets
LH-297.
;)
Travis Bell Erabiltzailearen Erantzuna
Azaroa 4, 2013 egunean 5:36 PM(e)tan
Person TV credit methods are now available: http://docs.themoviedb.apiary.io/#people
I also added
/credit/:idmethod. For more information about this and what it's intended to provide, please read the documentation.Cheers.
javikr Erabiltzailearen Erantzuna
Azaroa 5, 2013 egunean 7:00 AM(e)tan
Hi! First of all, thank you very much for your really good work :)
Just one "recommendation": it would be great if we could access to the popular tv shows, top rated and "now playing" like in the movie methods.
I don't know if you are currently working on this..
Best, Javier.
Stuart Boston Erabiltzailearen Erantzuna
Azaroa 5, 2013 egunean 7:50 AM(e)tan
I notice that you've split credits into
tv_credits,movie_credits&combined_credits.I presume that the current
/creditredirects to/movie_creditsis this correct?I did check the output and that's what it seems, but I wanted to verify