Database stats
GET/v1.3/meta/stats
How many titles, people, media, ratings and IDs the database holds, and how complete it is.
A snapshot of the database: the landing page takes its numbers from it, and you can show them too or track growth. The snapshot is recomputed every few hours; the time is in generated_at. You can keep the response for an hour.
Most counters cover the whole database, shorts and announcements included. The catalog block describes the “clean” catalog, what a person sees: titles with 300 votes or more, without shorts and adult films. It shows how complete the data is: 89.6% of those titles have Kinopoisk, IMDb and TMDB IDs, and 97.6% have a Russian overview.
Response fields
generated_atstringWhen the snapshot was computed, ISO 8601 in UTC.
titlesobjectTitles:
totaland by kind:movies,series(with miniseries and TV shows),cartoons,anime,shorts.personsobjectPeople. The three sources aren’t fully merged, so the head count is a range:
total_minis the largest source,total_maxthe sum of sources (it can benulluntil the snapshot is recomputed). Pluswith_photoandwith_biography.companiesintegerCompanies.
mediaobjectimages,videos, andtrailersamong them.episodesobjectEpisodes:
total, andseries, how many series have them.votesobjectViewer and critic ratings:
total,sources(how many sources), and the sum per source:kp,imdb,tmdb,kinorium,letterboxd,rt,metacritic. Letterboxd has more ratings than IMDb: Barbie has 5.1 million there against 0.7 million on IMDb.awardsobjectAwards:
nominations(wins included),wins,ceremonies,oscars.textsobjectfacts,quotes,faq,taglines,parental_guides.akasobjectAlternative titles:
total, andregions, how many regions.watchobject“Where to watch”:
links,services, andtitles, how many titles have links.classificationobjectcountries,languages,subgenres,keywords,moodsandearliest_year.releaseobjectworld_premieres,digital_releases,budgets,box_office: how many titles have them.idsobjectIDs:
total, per catalog (imdb,kp,tmdb,kinorium), andtitles_in_2plus, how many titles have IDs from two catalogs or more.franchise_linksintegerLinks within franchises.
intakeobjectGrowth:
daily_median, the median of new titles per day overwindow_daysdays.catalogobjectThe “clean” catalog: its conditions
min_votesandexcludes, its size (titles,movies,series) and completeness in percent:linked_pct, with Kinopoisk, IMDb and TMDB IDs;kp_imdb_pct, with Kinopoisk and IMDb IDs;poster_pct,overview_ru_pct,rated_3plus_pct.popularityarrayCompleteness of the most popular titles:
top, how many were taken;linked_pct, the share with Kinopoisk, IMDb and TMDB IDs;all_ids_pct, the share with IDs from all four catalogs.
Errors
| status | code | when |
|---|---|---|
| 400 | invalid_request | A query parameter other than |
| 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.