Enums
GET/v1.3/enums
Every closed set of values in the API, labeled in Russian and English, for your types and UI.
This is every value the API returns as a code: title kinds, roles, kinds of media and releases, statuses, age ratings. Each value has the labels label_ru and label_en: use them in your UI, and write your code and types against value.
The sets change only with a new API version. You can keep the response for a day (Cache-Control: max-age=86400 says so) and then revalidate with the ETag: a 304 is free.
| set | where it appears |
|---|---|
title_kinds | a title’s kind, the kind filter |
genres, regions | genres and country groups, the genre and region filters |
sort_keys, presets | the catalog’s sort keys and presets |
list_fields, title_fields, person_fields | names for fields in lists, the title card and people |
statuses | the release status on the card |
credit_roles | roles in cast and the filmography |
image_types, video_kinds | type in media |
text_kinds, fact_kinds, faq_link_types | texts |
relation_kinds | relation in relations |
release_types, release_regions | the release calendar |
title_release_types | release dates on the card |
age_limits, mpaa_ratings | age ratings and the age_limit, mpaa filters |
parental_categories, parental_severities | the parental guide on the card |
company_kinds | company roles and the company.kind filter |
site_kinds, site_sections | “where to watch” links on the card |
rating_sources | rating sources on the card |
sources | catalogs: imdb, kp, tmdb, kinorium |
tag_kinds | kinds of Kinorium tags |
genders | a person’s gender |
person_relations, marriage_statuses | the family on the person card |
zodiac_signs | a person’s zodiac sign |
education_types | kinds of schools in a person’s education |
Don’t need every set? Name the ones you want in set: set=credit_roles,genres. Countries and platforms are in filter values, along with how many titles each value has.
Query parameters
setcsvWhich sets to return, comma-separated.
Default:all
Example:set=credit_roles,genreslangru | enKeep one language in the response. Without it, text fields come in
_ruand_enpairs. More in Response languages.Example:lang=en
Response fields
setarrayA set of values, named as in the table above. In the order that suits display.
Show 3 fields
valuestringThe value as the API returns it.
label_ru · label_enstringThe label in Russian and in English.
Errors
| status | code | when |
|---|---|---|
| 400 | invalid_request | An unknown set in |
| 401 | unauthorized | The |
| 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.