Collections

GET/v1.3/collections

The list of collections: Kinopoisk tops refreshed every day, and editorial picks.

Collections come in two kinds:

• Kinopoisk tops: top-movies, top-series, popular-titles, weekly-trending-titles, daily-trending-titles. They mirror Kinopoisk’s lists and refresh every day; updated_at tells you when;
• editorial picks: short themed lists such as light-movies, single-location-movies, psychological-horror-movies, disaster-movies, true-story-movies.

q searches collections by name and description.

A collection’s titles are at /collections/{slug}.

Query parameters

• qstring

  Search by the collection’s name and description.

  Example: q=фильмы
• 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 collections to return, a whole number from 1 to 50.

  Default:

  50

• offsetinteger

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

  Default:

  0

Response fields

• itemsarray

  Collections.

  +−Show 9 fields

  • slugstring

    The collection’s name in the URL and in the catalog’s collection filter.

  • name_ru · name_enstring | null

    Name.

  • description_ru · description_enstring | null

    Description. Editorial collections may have none.

  • poster_urlstring | null

    The collection’s cover image. Without one of its own, the first title’s poster.

  • items_countinteger

    How many titles the collection holds.

  • created_at · updated_atstring

    When the collection was created and when its contents last changed, ISO 8601 in UTC.

• total · limit · offset · has_more

  Paging, as in every list.

Errors