Release calendar

GET/v1.3/releases

What comes out in theaters and online, and which seasons start, by date and region.

A calendar row is one release: the title, and in release when, where and how it comes out. A film that comes out digitally in Russia, the US and worldwide on the same day makes three rows.

Without parameters the calendar shows 30 days from today, nearest dates first; within a day, announcements without votes go by TMDB popularity. Set the window with from and to, at most 400 days long. released=true keeps the releases in the window that have happened, released=false the upcoming ones; for “out this week, newest first”, set from a week back and add released=true&sort=-date.

For a “Coming soon to theaters” storefront, take Russian theatrical releases and sort them by how well known they are: type=cinema&region=ru&sort=-votes_total. The catalog’s filters work here (kind, genre, country, required=poster), and so does fields.

Season premieres and release rows carry no region, so region with them returns 400: ask type=cinema,digital&region=ru and type=series separately. The calendar hides titles with neither a Russian nor an English name; include_obscure=true shows them.

Query parameters

• typecsv

  Kinds of release, comma-separated. Labels are in /enums, set release_types.

  cinemadigitalseriesrelease
  Default:

  all

  Example: type=cinema
• regioncsv

  Regions, comma-separated. Only for cinema and digital.

  ruusworld
  Default:

  all

  Example: region=ru
• from · todate

  The calendar window, YYYY-MM-DD, both dates inclusive. At most 400 days long.

  Default:

  today plus 30 days

  Example: from=2026-11-01&to=2026-11-30
• releasedboolean

  true keeps releases that have happened, false upcoming ones.

  Default:

  both

• sortenum

  date or +date: earliest first; -date: latest first; -votes_total: titles with the most votes first.

  date-date-votes_total
  Default:

  date

  Example: sort=-votes_total
• include_obscureboolean

  true also shows titles with neither a Russian nor an English name, and titles without a poster or 50 votes.

  Default:

  false

• catalog filters

  The catalog’s filters: kind=movie, genre=horror, country=ru, required=poster. Details in Filters and sorting.

• fieldscsv

  Which item fields to return, as in the catalog, plus release. IDs always come back.

  Example: fields=title,poster_url,release
• 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 rows to return, a whole number from 1 to 50.

  Default:

  50

  Example: limit=20
• offsetinteger

  How many rows to skip, a whole number from 0.

  Default:

  0

Response fields

• from · tostring

  The calendar window the API applied.

• type · regionarray | null

  The type and region from the request. null means no selection.

• itemsarray

  Calendar rows: the title card, as in the catalog, and the release event.

  +−Show 25 fields

  • imdb_id · kp_id · tmdb_id · tmdb_tv_id · kinorium_idstring | null

    The title’s catalog IDs. Always returned, even with fields.

  • title_ru · title_en · title_originalstring | null

    Titles: Russian, English and in the original language.

  • yearinteger | null

    Release year.

  • release_datestring | null

    First release date, YYYY-MM-DD.

  • kindenum

    Kind of title: movie, series, mini_series, tv_show, anime, cartoon, short.

  • poster_url_ru · poster_url_enstring | null

    Poster for a Russian and an English storefront.

  • posters_by_sourceobject

    Each source’s poster: kp, tmdb, imdb, kinorium.

  • rating_kp · rating_tmdb · rating_imdb · rating_kr · rating_letterboxdnumber | null

    Kinopoisk, TMDB, IMDb, Kinorium and Letterboxd ratings, 0–10 scale.

  • votes_kp · votes_tmdb · votes_imdbinteger | null

    Kinopoisk, TMDB and IMDb votes.

  • countriesarray

    Countries: code, name_ru, name_en.

  • genresarray

    Genres: slug, name_ru, name_en.

  • releaseobject

    The release event.

    +−Show 5 fields

    • typeenum

      cinema: in theaters; digital: on streaming and digital stores; series: a season premiere; release: a release whose source gave neither a kind nor a region.

      cinemadigitalseriesrelease
    • regionenum | null

      ru: Russia; us: the United States; world: a worldwide release not tied to a country. null for series and release.

      ruusworld
    • datestring

      Release date, YYYY-MM-DD.

    • rereleaseboolean

      A re-release: Twilight back in theaters.

    • seasoninteger | null

      The season number for series.

• totalinteger

  How many rows the window holds, filters applied.

• limit · offset · has_more

  Paging, as in every list.

Errors