# Top chart > The best-rated movies and series above a vote threshold, for rankings and “top 100” lists. > Documentation index for agents: https://kinodata.space/en/llms.txt — the whole documentation in one file: https://kinodata.space/en/llms-full.txt Request: `GET https://api.kinodata.space/v1.3/charts/top` The chart is the catalog with the `top` preset: `/titles?preset=top` gives the same response. It takes titles with at least 100,000 IMDb votes, a Kinopoisk rating and a poster, ordered by IMDb rating. The threshold drops ratings a handful of people gave. Everything the catalog understands works here: filters, `q`, `sort`, `fields` and the cursor. `order=asc` turns the chart upside down: the 2025 *Snow White* with 2.2 comes first. Move the threshold with `votes_imdb.gte`. You need that for cinema that is little watched abroad: *Brigada* and *The Island* gather 10,000–20,000 votes on IMDb, so with the 100,000 threshold they aren’t in the chart. `country=ru&votes_imdb.gte=10000` gives *Brigada*, *The Fool*, *The Return* and *The Island*. ## Query parameters - `filters, q and sort` — Everything the [catalog](https://kinodata.space/en/docs/titles.md) understands: filters, the `q` search, `sort` with a sign, `fields` and the `cursor`. Details in [Filters and sorting](https://kinodata.space/en/docs/filters.md). Example: `kind=movie&country=fr`. - `lang` (ru | en) — Keep one language in the response. Without it, text fields come in `_ru` and `_en` pairs. More in [Response languages](https://kinodata.space/en/docs/languages.md). Example: `lang=en`. - `limit` (integer) — How many titles to return, a whole number from 1 to 50. Default: 50. Example: `limit=20`. - `offset` (integer) — How many titles to skip, a whole number from 0. Default: 0. ## Response fields - `items` (array) — Titles: the same card as in the [catalog](https://kinodata.space/en/docs/titles.md). - `imdb_id`, `kp_id`, `tmdb_id`, `tmdb_tv_id`, `kinorium_id` (string | null) — The title’s catalog IDs. Always returned, even with `fields`. - `title_ru`, `title_en`, `title_original` (string | null) — Titles: Russian, English and in the original language. - `year` (integer | null) — Release year. - `release_date` (string | null) — First release date, `YYYY-MM-DD`. - `kind` (enum) — Kind of title: `movie`, `series`, `mini_series`, `tv_show`, `anime`, `cartoon`, `short`. - `poster_url_ru`, `poster_url_en` (string | null) — Poster for a Russian and an English storefront. - `posters_by_source` (object) — Each source’s poster: `kp`, `tmdb`, `imdb`, `kinorium`. - `rating_kp`, `rating_tmdb`, `rating_imdb`, `rating_kr`, `rating_letterboxd` (number | null) — Kinopoisk, TMDB, IMDb, Kinorium and Letterboxd ratings, 0–10 scale. - `votes_kp`, `votes_tmdb`, `votes_imdb` (integer | null) — Kinopoisk, TMDB and IMDb votes. - `countries` (array) — Countries: `code`, `name_ru`, `name_en`. - `genres` (array) — Genres: `slug`, `name_ru`, `name_en`. - `total` (null) — As in the catalog: the total isn’t counted. Page by `has_more` or with the cursor. - `limit`, `offset`, `has_more`, `next_cursor` — Paging, as in the [catalog](https://kinodata.space/en/docs/titles.md). ## Errors | status | code | when | |---|---|---| | 400 | `invalid_request` | Everything that returns `400` in the catalog, plus a `preset` of your own: this feed already is `preset=top`. | | 401 | `unauthorized` | The `X-API-Key` header is missing, or the key is unknown or revoked. | | 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](https://kinodata.space/en/docs/errors.md) page. ## Examples ### English only ```bash curl -G -H "X-API-Key: $KINODATA_KEY" \ --data-urlencode "limit=3" \ --data-urlencode "fields=title,year,rating_imdb,votes_imdb" \ --data-urlencode "lang=en" \ "https://api.kinodata.space/v1.3/charts/top" ``` Response `200`: ```json { "has_more": true, "items": [ { "imdb_id": "tt0903747", "kp_id": "404900", "tmdb_id": null, "tmdb_tv_id": "1396", "kinorium_id": "400796", "title_en": "Breaking Bad", "year": 2008, "rating_imdb": 9.5, "votes_imdb": 2671962 }, { "imdb_id": "tt5491994", "kp_id": "1007472", "tmdb_id": null, "tmdb_tv_id": "68595", "kinorium_id": "1605088", "title_en": "Planet Earth II", "year": 2016, "rating_imdb": 9.4, "votes_imdb": 175688 }, { "imdb_id": "tt0795176", "kp_id": "279548", "tmdb_id": null, "tmdb_tv_id": "1044", "kinorium_id": "379535", "title_en": "Planet Earth", "year": 2006, "rating_imdb": 9.4, "votes_imdb": 235430 } ], "limit": 3, "offset": 0, "total": null } ``` ### Both languages ```bash curl -G -H "X-API-Key: $KINODATA_KEY" \ --data-urlencode "limit=3" \ --data-urlencode "fields=title,year,rating_imdb,votes_imdb" \ "https://api.kinodata.space/v1.3/charts/top" ``` Response `200`: ```json { "has_more": true, "items": [ { "imdb_id": "tt0903747", "kp_id": "404900", "tmdb_id": null, "tmdb_tv_id": "1396", "kinorium_id": "400796", "title_ru": "Во все тяжкие", "title_en": "Breaking Bad", "year": 2008, "rating_imdb": 9.5, "votes_imdb": 2671962 }, { "imdb_id": "tt5491994", "kp_id": "1007472", "tmdb_id": null, "tmdb_tv_id": "68595", "kinorium_id": "1605088", "title_ru": "Планета Земля 2", "title_en": "Planet Earth II", "year": 2016, "rating_imdb": 9.4, "votes_imdb": 175688 }, { "imdb_id": "tt0795176", "kp_id": "279548", "tmdb_id": null, "tmdb_tv_id": "1044", "kinorium_id": "379535", "title_ru": "Планета Земля", "title_en": "Planet Earth", "year": 2006, "rating_imdb": 9.4, "votes_imdb": 235430 } ], "limit": 3, "offset": 0, "total": null } ``` ### Russian cinema ```bash curl -G -H "X-API-Key: $KINODATA_KEY" \ --data-urlencode "country=ru" \ --data-urlencode "votes_imdb.gte=10000" \ --data-urlencode "limit=4" \ --data-urlencode "fields=title,year,rating_imdb,votes_imdb" \ "https://api.kinodata.space/v1.3/charts/top" ``` Response `200`: ```json { "has_more": true, "items": [ { "imdb_id": "tt0337898", "kp_id": "77039", "tmdb_id": null, "tmdb_tv_id": "30877", "kinorium_id": "265889", "title_ru": "Бригада", "title_en": "Brigada", "year": 2002, "rating_imdb": 8.3, "votes_imdb": 11920 }, { "imdb_id": "tt3560686", "kp_id": "808639", "tmdb_id": "285700", "tmdb_tv_id": null, "kinorium_id": "744021", "title_ru": "Дурак", "title_en": "The Fool", "year": 2014, "rating_imdb": 8, "votes_imdb": 18872 }, { "imdb_id": "tt0376968", "kp_id": "47040", "tmdb_id": "11190", "tmdb_tv_id": null, "kinorium_id": "294021", "title_ru": "Возвращение", "title_en": "The Return", "year": 2003, "rating_imdb": 7.9, "votes_imdb": 48111 }, { "imdb_id": "tt0851577", "kp_id": "257337", "tmdb_id": "22358", "tmdb_tv_id": null, "kinorium_id": "392732", "title_ru": "Остров", "title_en": "The Island", "year": 2006, "rating_imdb": 7.8, "votes_imdb": 13304 } ], "limit": 4, "offset": 0, "total": null } ``` ### Bottom up ```bash curl -G -H "X-API-Key: $KINODATA_KEY" \ --data-urlencode "order=asc" \ --data-urlencode "limit=3" \ --data-urlencode "fields=title,year,rating_imdb,votes_imdb" \ "https://api.kinodata.space/v1.3/charts/top" ``` Response `200`: ```json { "has_more": true, "items": [ { "imdb_id": "tt6208148", "kp_id": "1009713", "tmdb_id": "447273", "tmdb_tv_id": null, "kinorium_id": "1618157", "title_ru": "Белоснежка", "title_en": "Snow White", "year": 2025, "rating_imdb": 2.2, "votes_imdb": 396915 }, { "imdb_id": "tt0799949", "kp_id": "260526", "tmdb_id": "9760", "tmdb_tv_id": null, "kinorium_id": "380419", "title_ru": "Очень эпическое кино", "title_en": "Epic Movie", "year": 2006, "rating_imdb": 2.5, "votes_imdb": 113889 }, { "imdb_id": "tt12915716", "kp_id": "1400400", "tmdb_id": "734253", "tmdb_tv_id": null, "kinorium_id": "2454330", "title_ru": "Адипуруш", "title_en": "Adipurush", "year": 2023, "rating_imdb": 2.6, "votes_imdb": 137652 } ], "limit": 3, "offset": 0, "total": null } ```