API Changelog


david wrote a year ago:

This is a pre-announcement for a change to be rolled out in the next week.

"Air times" will be removed from web-channel shows, like Netflix or Hulu. Since web channels rarely announce the exact time when new episodes are released, this'll help avoid edit conflicts and ambiguous data.

In the API, the "airtime" property for such episodes will then always return an empty string. The "airstamp" property will use the episode's regular release date, set to 12:00 (12 in the afternoon) in the UTC timezone.


david wrote a year ago:

Please carefully study our new documentation about rate limiting here: http://www.tvmaze.com/api#Rate_limiting

TL;DR: Make your client gracefully handles HTTP 429 responses. If you receive one, don't treat it as a permanent failure, but halt all requests for a few seconds then retry.


david wrote a year ago:

There have been a few improvements as part of the infrastructure maintenance from two weeks ago. Some highlights:

- HTTPS (and with it, HTTP2) is now available for the (premium) user-level API (http://tvmazecdn.com/apidoc/)

- gzip is now enabled

- Support for If-Modified-Since on most endpoints


david wrote a year ago:

We're soon moving the image links in the API (like http://tvmazecdn.com/uploads/images/medium_portrait/31/78286.jpg) to a different subdomain with HTTPS.

If your application uses the full image URL as cache key, this change means the images might be re-downloaded. If you want to prevent that, you'll have to match on the path alone instead of the full URL.


david wrote 2 months ago:

Heads up! In the near future, Web Channel episodes will start appearing in the schedule. Please be prepared for episodes (as already happens elsewhere in the API) with the network property set to NULL, because they air on a Web Channel instead.