Episodes

GET/v1.3/titles/{type}/{id}/episodes

A series’ episodes: titles, overviews, air dates, runtime and ratings.

Episodes come in order: season, then episode number. season keeps one season.

group=season returns a summary instead of episodes: one row per season with the episode count, dates and rating. Draw a season list from it without loading every episode.

Specials come as season 0 and are marked special: true. A movie has no episodes: the response is total: 0 with empty items, which is not an error.

Path parameters

typestringrequired
The catalog the ID comes from: IMDb, Kinopoisk, TMDB (movie or series) or Kinorium.
imdbkptmdbtmdb_tvkinorium
idstringrequired
The ID in that catalog. IMDb IDs are tt followed by digits (tt1375666); the others are digits (447301).

Query parameters

seasoninteger
Season number. 0 means specials.
Default:
every season
Example: season=1
groupenum
season gives a per-season summary instead of episodes. none gives episodes.
seasonnone
Default:
none
langru | en
Keep one language in the response. Without it, text fields come in _ru and _en pairs. More in Response languages.
Example: lang=en
limitinteger
How many episodes to return, up to 1000.
Default:
1000
offsetinteger
How many episodes to skip.
Default:
0

Response fields

itemsarray
Episodes.
Show 17 fields
- season · episodeinteger
  Season and episode number.
- specialboolean
  A special.
- imdb_idstring | null
  The episode’s IMDb ID.
- air_datestring | null
  Air date, YYYY-MM-DD.
- name_ru · name_enstring | null
  Episode title.
- name_originalstring | null
  Title in the original language, when it is neither Russian nor English.
- overview_ru · overview_enstring | null
  Episode overview.
- short_overview_ru · short_overview_enstring | null
  A one- or two-sentence overview. The English one comes from IMDb.
- runtimeinteger | null
  Runtime in minutes.
- rating_imdb · votes_imdbnumber | null
  IMDb rating and vote count.
- rating_krnumber | null
  Kinorium rating.
- still_urlstring | null
  A still from the episode.
items with group=seasonarray
A per-season summary.
Show 7 fields
- seasoninteger
  Season number.
- episodesinteger
  How many episodes it has.
- first_air · last_airstring | null
  Air dates of the first and the last episode.
- rating_imdbnumber | null
  The average IMDb rating across the season’s episodes.
- votes_imdbinteger | null
  The sum of IMDb votes across the season’s episodes.
- specialsboolean
  This is the specials season.
total · limit · offset · has_more
Paging, as in every list.

Errors

status	code	when
400	invalid_request	`season` is not a number or is negative; an unknown `group`; a parameter this list doesn’t understand (such as `sort` or `fields`); the response lists the allowed ones.
404	not_found	No title found for this ID.
401	unauthorized	The `X-API-Key` header is missing, or the key is unknown or revoked.
429	rate_limited	The per-second rate limit or the daily quota is used up.

Every code and what to do about it is on the Errors page.