The Movie Database Support
Support → API Support
TV API Preview
posted by Travis BellSTAFFMOD on Oktober 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 iGriever
on Mei 30, 2014 at 12:09 PM
Any chance to have a deeper control on the
tv/{id}/similar/method? It would be cool to have similar filters as those available for thediscovermethod. At the moment a ton of shows are associated to the specified one, so it really defeats the purpose of finding really similar shows.Reply by Razze
on Juni 3, 2014 at 10:06 AM
It would really help if we could also find by tvdb ids At the moment if your working with trakt its like, search for the tvdb id and get the tmdb id then find with the tmdb id
Reply by Travis Bell
on Juni 3, 2014 at 10:22 AM
You can ;)
http://docs.themoviedb.apiary.io/#find
Reply by Razze
on Juni 3, 2014 at 10:53 AM
Sorry, I was under the wrong impression, that you can also query the movie endpoint with a imdb id. Forget it ;)
Any chance for DVD orders for tv shows in the api?
Reply by Travis Bell
on Juni 3, 2014 at 11:12 AM
I have an open ticket to think about that but as it stands right now we don't even have that data stored.
Until it gets looked at, everything on TMDb is assumed to be air date orders.
Reply by Razze
on Juni 3, 2014 at 11:30 AM
Thank you. Best examples I know of are Batman The Animated Series and Firefly
Reply by b3nitro
on Desember 29, 2014 at 11:00 AM
Would be nice to include seasons into the search/tv method. Ex: searching for games of thrones will return, global games of thrones + games of thrones s01, games of thrones s02, .. With season_number or similar in the reply of the appropriate results
Reply by vairavelr
on Januari 26, 2015 at 1:43 AM
please help me to make URL to watch tv?
Reply by Travis Bell
on Juni 23, 2015 at 4:04 PM
Hi danasu23,
I'm not sure what you mean:
Is what a valid request looks like.
Reply by danasu23
on Juni 23, 2015 at 4:12 PM
i was try but Parse error: syntax error, unexpected
Reply by Travis Bell
on Juni 23, 2015 at 4:14 PM
You'll have to elaborate. Sounds like an issue with whatever language/parser you are using.
Reply by danasu23
on Juni 23, 2015 at 4:17 PM
https://api.themoviedb.org/3/tv/1396?api_key=my_api/season/1/episode/2
Reply by Travis Bell
on Juni 24, 2015 at 11:14 AM
That's not a valid query.
Would be what you're looking for.
Reply by bmbrina
on Juni 25, 2015 at 11:52 AM
Could you help me format a query that gets you the poster image for a tv show, I have tried different ways and I can't seem to get it right. I have extracted the "poster_path" from the JSON but I don't know where it goes.
Thank you in advance!!
Reply by Travis Bell
on Juni 25, 2015 at 12:11 PM
You can read about how to build image URL's here: http://docs.themoviedb.apiary.io/#reference/configuration
Cheers.