# Статистика базы

> Сколько в базе тайтлов, людей, медиа, оценок, ID и насколько она полна.

> Оглавление документации для агентов: https://kinodata.space/ru/llms.txt — вся документация одним файлом: https://kinodata.space/ru/llms-full.txt

Запрос: `GET https://api.kinodata.space/v1.3/meta/stats`

Снимок базы: из него лендинг берёт цифры, а вы можете показать их у себя или следить за ростом. Снимок пересчитывается раз в несколько часов, время — в `generated_at`. Ответ можно хранить час.

Счётчики в большинстве своём — по всей базе, вместе с короткометражками и анонсами. Блок `catalog` описывает «чистый» каталог — то, что видит человек: тайтлы от 300 голосов, без короткого метра и фильмов для взрослых. По нему видно, насколько полны данные: у 89,6% таких тайтлов есть ID Кинопоиска, IMDb и TMDB, у 97,6% — русское описание.

## Поля ответа

- `generated_at` (string) — Когда снимок посчитан, ISO 8601 в UTC.
- `titles` (object) — Тайтлы: `total` и по видам — `movies`, `series` (с мини-сериалами и ТВ-шоу), `cartoons`, `anime`, `shorts`.
- `persons` (object) — Люди. Три источника сведены не до конца, поэтому число людей — промежуток: `total_min` — самый большой источник, `total_max` — сумма источников (может быть `null`, пока снимок не пересчитан). И `with_photo`, `with_biography`.
- `companies` (integer) — Компании.
- `media` (object) — `images`, `videos` и среди них `trailers`.
- `episodes` (object) — Серии: `total` и `series` — у скольких сериалов они есть.
- `votes` (object) — Оценки зрителей и критиков: `total`, `sources` — сколько источников, и сумма по каждому: `kp`, `imdb`, `tmdb`, `kinorium`, `letterboxd`, `rt`, `metacritic`. У Letterboxd оценок больше, чем у IMDb: у «Барби» там 5,1 млн оценок против 0,7 млн на IMDb.
- `awards` (object) — Награды: `nominations` (с победами), `wins`, `ceremonies`, `oscars`.
- `texts` (object) — `facts`, `quotes`, `faq`, `taglines`, `parental_guides`.
- `akas` (object) — Другие названия: `total` и `regions` — в скольких регионах.
- `watch` (object) — «Где смотреть»: `links`, `services`, `titles` — у скольких тайтлов есть ссылки.
- `classification` (object) — `countries`, `languages`, `subgenres`, `keywords`, `moods` и `earliest_year`.
- `release` (object) — `world_premieres`, `digital_releases`, `budgets`, `box_office` — у скольких тайтлов они известны.
- `ids` (object) — ID: `total`, по каталогам — `imdb`, `kp`, `tmdb`, `kinorium` — и `titles_in_2plus`: у скольких тайтлов ID из двух каталогов и больше.
- `franchise_links` (integer) — Связи внутри франшиз.
- `intake` (object) — Прирост: `daily_median` — медиана новых тайтлов в день за `window_days` дней.
- `catalog` (object) — «Чистый» каталог: условия `min_votes` и `excludes`, размер (`titles`, `movies`, `series`) и полнота в процентах: `linked_pct` — с ID Кинопоиска, IMDb и TMDB, `kp_imdb_pct` — с ID Кинопоиска и IMDb, `poster_pct`, `overview_ru_pct`, `rated_3plus_pct`.
- `popularity` (array) — Полнота самых популярных тайтлов: `top` — сколько первых взято, `linked_pct` — доля с ID Кинопоиска, IMDb и TMDB, `all_ids_pct` — с ID всех четырёх каталогов.

## Ошибки

| статус | код | когда |
|---|---|---|
| 400 | `invalid_request` | Параметр запроса, кроме `lang`. |
| 401 | `unauthorized` | Нет заголовка `X-API-Key`, ключ неизвестен или отозван. |
| 429 | `rate_limited` | Исчерпан предел в секунду или квота на сутки. |

Все коды и что с ними делать — на странице [Ошибки](https://kinodata.space/ru/docs/errors.md).

## Примеры

### Снимок

```bash
curl -H "X-API-Key: $KINODATA_KEY" \
  "https://api.kinodata.space/v1.3/meta/stats"
```

Ответ `200`:

```json
{
  "generated_at": "2026-10-12T12:23:50.968333464Z",
  "titles": {
    "total": 1439816,
    "movies": 709712,
    "series": 205938,
    "cartoons": 68900,
    "anime": 8830,
    "shorts": 446436
  },
  "persons": {
    "total_min": 5280041,
    "total_max": 13431951,
    "with_photo": 439134,
    "with_biography": 147813
  },
  "companies": 394809,
  "media": {
    "images": 9692643,
    "videos": 210043,
    "trailers": 118409
  },
  "episodes": {
    "total": 7160687,
    "series": 208110
  },
  "votes": {
    "total": 5107770117,
    "sources": 7,
    "kp": 1415059430,
    "imdb": 1562238698,
    "tmdb": 31064600,
    "kinorium": 46124910,
    "letterboxd": 2051246620,
    "rt": 1619408,
    "metacritic": 416451
  },
  "awards": {
    "nominations": 73381,
    "wins": 20683,
    "ceremonies": 29,
    "oscars": 2239
  },
  "texts": {
    "facts": 107166,
    "quotes": 16922,
    "faq": 65939,
    "taglines": 226237,
    "parental_guides": 22820
  },
  "akas": {
    "total": 2758617,
    "regions": 349
  },
  "watch": {
    "links": 156117,
    "services": 161,
    "titles": 61677
  },
  "classification": {
    "countries": 234,
    "languages": 172,
    "subgenres": 239,
    "keywords": 23059,
    "moods": 448,
    "earliest_year": 1888
  },
  "release": {
    "world_premieres": 764603,
    "digital_releases": 114736,
    "budgets": 64666,
    "box_office": 22899
  },
  "ids": {
    "total": 4005179,
    "imdb": 1132659,
    "kp": 843332,
    "tmdb": 1006866,
    "kinorium": 1022322,
    "titles_in_2plus": 1144249
  },
  "franchise_links": 1016842,
  "intake": {
    "daily_median": 465,
    "window_days": 30
  },
  "catalog": {
    "min_votes": 300,
    "excludes": [
      "short",
      "adult"
    ],
    "titles": 158575,
    "movies": 116393,
    "series": 27271,
    "linked_pct": 89.6,
    "kp_imdb_pct": 92.8,
    "poster_pct": 99.4,
    "overview_ru_pct": 97.6,
    "rated_3plus_pct": 70.5
  },
  "popularity": [
    {
      "top": 1000,
      "titles": 1000,
      "linked_pct": 99.8,
      "all_ids_pct": 99.8
    },
    {
      "top": 10000,
      "titles": 10000,
      "linked_pct": 97.4,
      "all_ids_pct": 97.2
    },
    {
      "top": 100000,
      "titles": 100000,
      "linked_pct": 91.1,
      "all_ids_pct": 89.5
    }
  ]
}
```