Статистика базы
GET/v1.3/meta/stats
Сколько в базе тайтлов, людей, медиа, оценок, ID и насколько она полна.
Снимок базы: из него лендинг берёт цифры, а вы можете показать их у себя или следить за ростом. Снимок пересчитывается раз в несколько часов, время — в generated_at. Ответ можно хранить час.
Счётчики в большинстве своём — по всей базе, вместе с короткометражками и анонсами. Блок catalog описывает «чистый» каталог — то, что видит человек: тайтлы от 300 голосов, без короткого метра и фильмов для взрослых. По нему видно, насколько полны данные: у 89,6% таких тайтлов есть ID Кинопоиска, IMDb и TMDB, у 97,6% — русское описание.
Поля ответа
generated_atstringКогда снимок посчитан, ISO 8601 в UTC.
titlesobjectТайтлы:
totalи по видам —movies,series(с мини-сериалами и ТВ-шоу),cartoons,anime,shorts.personsobjectЛюди. Три источника сведены не до конца, поэтому число людей — промежуток:
total_min— самый большой источник,total_max— сумма источников (может бытьnull, пока снимок не пересчитан). Иwith_photo,with_biography.companiesintegerКомпании.
mediaobjectimages,videosи среди нихtrailers.episodesobjectСерии:
totalиseries— у скольких сериалов они есть.votesobjectОценки зрителей и критиков:
total,sources— сколько источников, и сумма по каждому:kp,imdb,tmdb,kinorium,letterboxd,rt,metacritic. У Letterboxd оценок больше, чем у IMDb: у «Барби» там 5,1 млн оценок против 0,7 млн на IMDb.awardsobjectНаграды:
nominations(с победами),wins,ceremonies,oscars.textsobjectfacts,quotes,faq,taglines,parental_guides.akasobjectДругие названия:
totalиregions— в скольких регионах.watchobject«Где смотреть»:
links,services,titles— у скольких тайтлов есть ссылки.classificationobjectcountries,languages,subgenres,keywords,moodsиearliest_year.releaseobjectworld_premieres,digital_releases,budgets,box_office— у скольких тайтлов они известны.idsobjectID:
total, по каталогам —imdb,kp,tmdb,kinorium— иtitles_in_2plus: у скольких тайтлов ID из двух каталогов и больше.franchise_linksintegerСвязи внутри франшиз.
intakeobjectПрирост:
daily_median— медиана новых тайтлов в день заwindow_daysдней.catalogobject«Чистый» каталог: условия
min_votesиexcludes, размер (titles,movies,series) и полнота в процентах:linked_pct— с ID Кинопоиска, IMDb и TMDB,kp_imdb_pct— с ID Кинопоиска и IMDb,poster_pct,overview_ru_pct,rated_3plus_pct.popularityarrayПолнота самых популярных тайтлов:
top— сколько первых взято,linked_pct— доля с ID Кинопоиска, IMDb и TMDB,all_ids_pct— с ID всех четырёх каталогов.
Ошибки
| статус | код | когда |
|---|---|---|
| 400 | invalid_request | Параметр запроса, кроме |
| 401 | unauthorized | Нет заголовка |
| 429 | rate_limited | Исчерпан предел в секунду или квота на сутки. |
Все коды и что с ними делать — на странице Ошибки.