The Movie Database-ondersteuning
Ondersteuning → API-ondersteuning
TV API Preview
geplaatst door Travis BellSTAFFMOD op 24 oktober 2013 om 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
Reactie van iGriever
op 30 mei 2014 om 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.Reactie van Razze
op 3 juni 2014 om 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
Reactie van Travis Bell
op 3 juni 2014 om 10:22 AM
You can ;)
http://docs.themoviedb.apiary.io/#find
Reactie van Razze
op 3 juni 2014 om 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?
Reactie van Travis Bell
op 3 juni 2014 om 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.
Reactie van Razze
op 3 juni 2014 om 11:30 AM
Thank you. Best examples I know of are Batman The Animated Series and Firefly
Reactie van b3nitro
op 29 december 2014 om 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
Reactie van vairavelr
op 26 januari 2015 om 1:43 AM
please help me to make URL to watch tv?
Reactie van Travis Bell
op 23 juni 2015 om 4:04 PM
Hi danasu23,
I'm not sure what you mean:
Is what a valid request looks like.
Reactie van danasu23
op 23 juni 2015 om 4:12 PM
i was try but Parse error: syntax error, unexpected
Reactie van Travis Bell
op 23 juni 2015 om 4:14 PM
You'll have to elaborate. Sounds like an issue with whatever language/parser you are using.
Reactie van danasu23
op 23 juni 2015 om 4:17 PM
https://api.themoviedb.org/3/tv/1396?api_key=my_api/season/1/episode/2
Reactie van Travis Bell
op 24 juni 2015 om 11:14 AM
That's not a valid query.
Would be what you're looking for.
Reactie van bmbrina
op 25 juni 2015 om 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!!
Reactie van Travis Bell
op 25 juni 2015 om 12:11 PM
You can read about how to build image URL's here: http://docs.themoviedb.apiary.io/#reference/configuration
Cheers.