API Changelog

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.

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.

Support for show- and episode votes was added to the Premium user-API: http://tvmazecdn.com/apidoc/

Added support for show crew. For example: http://api.tvmaze.com/shows/1/crew

Added show_id filter to GET /user/episodes (http://tvmazecdn.com/apidoc/#!/marked_episodes/get_user_episodes)

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

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.

Added HTTPS support to the entire API: http://www.tvmaze.com/blogs/20/https-now-enabled-on-the-api

Added the "official site" property to shows.

You can now retrieve the episode list for a single season: http://api.tvmaze.com/seasons/1/episodes or http://api.tvmaze.com/seasons/1?embed=episodes. This endpoint will always include specials (episodes with a number set to NULL)

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.

January

Additional person information exposed: country, birthday, death day, gender

August

Add properties "self" and "voice" (booleans) to cast entries

April

Add show images: https://www.tvmaze.com/api#show-image

October

* Episodes now have a "type" property ("regular", "significant_special", "insignificant_special")

* Both significant specials and insignificant specials are included in the "/episodes?specials=1" endpoint

November

Added web (streaming) schedule endpoints: https://www.tvmaze.com/api#web-schedule

Heads-up: in the forseeable future, URLs in the API will use https by default.

March 2021

Exposed alternate episode lists (e.g. DVD ordering): https://www.tvmaze.com/api#show-alternate-lists

April 2021

Added the since parameter to the updates/shows endpoint: https://www.tvmaze.com/api#show-updates

Added image width and height properties to the shows/images endpoint (https://www.tvmaze.com/api#show-image)

Added the averageRuntime property to shows (https://www.tvmaze.com/api#show-main-information)

September 2021

Added the person index: https://www.tvmaze.com/api#person-index and exposed the updated property for people

Added the ended property to shows

October 2021

Added rating to episodes, see f.e. http://api.tvmaze.com/episodes/1

November 2022

Added endpoints for episode guest cast, e.g. https://api.tvmaze.com/episodes/1/guestcast and https://api.tvmaze.com/people/1/guestcastcredits.