Служба підтримки The Movie Database
Підтримка → Підтримка API
TV API Preview
створено Travis BellSTAFFMOD 24 жовтня 2013, 14:15
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
Відповідь від iGriever
30 травня 2014, 12:09
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.Відповідь від Razze
3 червня 2014, 10:06
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
Відповідь від Travis Bell
3 червня 2014, 10:22
You can ;)
http://docs.themoviedb.apiary.io/#find
Відповідь від Razze
3 червня 2014, 10:53
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?
Відповідь від Travis Bell
3 червня 2014, 11:12
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.
Відповідь від Razze
3 червня 2014, 11:30
Thank you. Best examples I know of are Batman The Animated Series and Firefly
Відповідь від b3nitro
29 грудня 2014, 11:00
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
Відповідь від vairavelr
26 січня 2015, 01:43
please help me to make URL to watch tv?
Відповідь від Travis Bell
23 червня 2015, 16:04
Hi danasu23,
I'm not sure what you mean:
Is what a valid request looks like.
Відповідь від danasu23
23 червня 2015, 16:12
i was try but Parse error: syntax error, unexpected
Відповідь від Travis Bell
23 червня 2015, 16:14
You'll have to elaborate. Sounds like an issue with whatever language/parser you are using.
Відповідь від danasu23
23 червня 2015, 16:17
https://api.themoviedb.org/3/tv/1396?api_key=my_api/season/1/episode/2
Відповідь від Travis Bell
24 червня 2015, 11:14
That's not a valid query.
Would be what you're looking for.
Відповідь від bmbrina
25 червня 2015, 11:52
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!!
Відповідь від Travis Bell
25 червня 2015, 12:11
You can read about how to build image URL's here: http://docs.themoviedb.apiary.io/#reference/configuration
Cheers.