Try 30 days of free premium.

New user: API feature requests

Sparky53 wrote 4 years ago: 1

Hi,

Few questions about the API (and the data that's available). Can I get access to?

 * Other posters/fanart (from the Gallery tab) (and ratings/votes)

 * Guest Stars

 * Episode ratings and votes

 * Episode Writer and Director

 * Show Creators

Thanks v much (am looking to move TVRename.com from TVDB to you guys)


gazza911 wrote 4 years ago: 3

1. We're still in the early stages of the new image functionality. It was added to the API mainly to allow Kodi to use it for the image selection. 

It is however, undocumented. It will return the following things:

Whether it's the main (poster) show image, type (e.g. Background) and resolutions available. You cannot get the ratings.

For unclassified images (uploads from prior to the newer image functionality) their type will be null.

The show image endpoint is /shows/:id/images, e.g. https://api.tvmaze.com/shows/1371/images

There isn't an equivalent endpoint for episodes (as Kodi did not need it), so you can only get the main image via https://api.tvmaze.com/episodes/1

Also see the information regarding images in general: https://www.tvmaze.com/api#images

2. Guest (Episode Level) cast is not available currently

3. Episode Level rating is not available currently

4. Guest (Episode Level) crew is not available currently

5. Creators (Show Level) are available on the crews endpoint; see https://www.tvmaze.com/api#show-crew

Sparky53 wrote 4 years ago: 1

Great - thanks so much for the quick reply. Couple of follow ups if that's OK?

a) Anywhere I can request the bits not available yet to be added to the API?

b) Any other undocumented embeds? Other than shows/x/images are the others all documented on https://www.tvmaze.com/api?

Thanks again

 


gazza911 wrote 4 years ago: 1

@Sparky53 wrote:
Great - thanks so much for the quick reply. Couple of follow ups if that's OK?

a) Anywhere I can request the bits not available yet to be added to the API?

b) Any other undocumented embeds? Other than shows/x/images are the others all documented on https://www.tvmaze.com/api?

Thanks again

 

Yep, we're always willing to answer to respond (even if it's not necessarily what you want to hear).

a) I'm fairly sure all of the episode requests have been requested before.

The image ratings are fairly new, but I can see how we could use it ourselves for Kodi.

In general, the suggestions forum is for the website, with API related feedback in this forum, so you can continue to post here. Similarly, the Pending Features forum is generally for the website (this isn't an exhaustive list and only represents what the users want to see added).

b) The only other 'undocumented' endpoint I'd say is http://api.tvmaze.com/characters/1 but that's because it doesn't really need to be; you only get the character ID from the cast endpoint - http://api.tvmaze.com/shows/1/cast - which already embeds it directly.

Sparky53 wrote 4 years ago: 1

Great - thanks very much Gazza for replying. Really enjoying the API so far. So much easier to use than TVDB and better designed.

Great work - thanks

Try 30 days of free premium.