Collection

GET/v1.3/collections/{slug}

A collection’s titles in the editor’s order, or with the catalog’s filters and sorting.

Without parameters a collection comes in the editor’s order: ord is the title’s place in it, from 1. For Kinopoisk tops, that is the place in the top.

Add a filter, a q search or sort, and the collection becomes a search scope: the catalog engine builds the answer, and ord keeps the original place. With a filter or q, total is null, as in the catalog. All the filters and sorting work here, and so does fields.

You can pick a collection’s titles in the catalog too: /titles?collection=popular-titles. It has a cursor but no ord.

Path parameters

• slugstringrequired

  The collection’s name from the list of collections.

  Example: top-movies

Query parameters

• filters, q and sort

  The catalog’s filters, search and sorting: kind=movie, q=matrix, sort=-rating_imdb. Details in Filters and sorting.

  Default:

  the editor’s order

• fieldscsv

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

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

  Default:

  50

  Example: limit=10
• offsetinteger

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

  Default:

  0

Response fields

• collectionobject

  The collection itself: the same object as in the list of 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.

• itemsarray

  Titles: the same card as in the catalog.

  +−Show 26 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.

  • ordinteger

    The title’s place in the collection, from 1.

  • notestring | null

    The editor’s note on the title.

• totalinteger | null

  How many titles the collection holds. null with a filter or q.

• limit · offset · has_more

  Paging, as in every list.

Errors