Skip to content
Sections: Enums

Values and stats

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.

setwhere it appears
title_kindsa title’s kind, the kind filter
genres, regionsgenres and country groups, the genre and region filters
sort_keys, presetsthe catalog’s sort keys and presets
list_fields, title_fields, person_fieldsnames for fields in lists, the title card and people
statusesthe release status on the card
credit_rolesroles in cast and the filmography
image_types, video_kindstype in media
text_kinds, fact_kinds, faq_link_typestexts
relation_kindsrelation in relations
release_types, release_regionsthe release calendar
title_release_typesrelease dates on the card
age_limits, mpaa_ratingsage ratings and the age_limit, mpaa filters
parental_categories, parental_severitiesthe parental guide on the card
company_kindscompany roles and the company.kind filter
site_kinds, site_sections“where to watch” links on the card
rating_sourcesrating sources on the card
sourcescatalogs: imdb, kp, tmdb, kinorium
tag_kindskinds of Kinorium tags
gendersa person’s gender
person_relations, marriage_statusesthe family on the person card
zodiac_signsa person’s zodiac sign
education_typeskinds 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

  • setcsv

    Which sets to return, comma-separated.

    Default:

    all

    Example: set=credit_roles,genres
  • 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

Response fields

  • setarray

    A set of values, named as in the table above. In the order that suits display.

    Show 3 fields
    • valuestring

      The value as the API returns it.

    • label_ru · label_enstring

      The label in Russian and in English.

Errors

statuscodewhen
400invalid_request

An unknown set in set, with the allowed ones in the response; a parameter this endpoint doesn’t understand (such as fields).

401unauthorized

The X-API-Key header is missing, or the key is unknown or revoked.

429rate_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.

Esc

Loading the index…

    ↑ ↓ to selectEnter to openEsc to close