# kinodata API > kinodata links the IDs of movies and series across IMDb, Kinopoisk, TMDB and Kinorium, and uses those links to serve title data: titles in Russian and English, every source’s ratings, cast, media, relations, filmographies, collections and a release calendar. - The base URL is `https://api.kinodata.space/v1.3`. Every request is a `GET`; the key goes in the `X-API-Key` header. - A successful response is the data itself, with no wrapper. An error is `{"error": {"code", "message", "field", "allowed", "hint"}}` with a 4xx or 5xx status. Branch on `error.code`. - Text fields come in `_ru` and `_en` pairs. `lang=ru` or `lang=en` keeps one half. A missing translation is `null`, never a substitute. - An unknown parameter or value returns `400` with the allowed values in `allowed` and a suggestion in `hint`. Don’t invent parameters: take them from the reference below. - Every docs page is available as Markdown: add `.md` to its URL. ## Getting started - [Introduction](https://kinodata.space/en/docs.md): What the kinodata API does, the base URL and the response format. - [Quickstart](https://kinodata.space/en/docs/quickstart.md): An API key, your first request, a title card and search in five minutes. - [Connect AI assistants](https://kinodata.space/en/docs/mcp.md): The kinodata MCP server: setup for Claude, Claude Code, Cursor and VS Code, the tools and how they use your quota. ## Essentials - [Keys and limits](https://kinodata.space/en/docs/keys.md): How to send the key, plan limits, balance headers and how to save requests. - [Response languages](https://kinodata.space/en/docs/languages.md): The language in the field name, the lang parameter and what is in one language only. - [Lists and pagination](https://kinodata.space/en/docs/lists.md): The shape of every list, pages and cursors, sections and choosing fields. - [Filters and sorting](https://kinodata.space/en/docs/filters.md): Operators, every catalog filter, sorting, the rating window and presets. - [Errors](https://kinodata.space/en/docs/errors.md): What an error looks like, what each code means and when to retry. ## Reference - [IDs in every catalog](https://kinodata.space/en/docs/ids.md): `GET /ids/{type}/{id}` — Takes a title’s ID in one catalog and returns its IDs in the others. - [Catalog and search](https://kinodata.space/en/docs/titles.md): `GET /titles` — Search titles by name and pick them from the whole database with filters. ## Title - [Title card](https://kinodata.space/en/docs/titles/card.md): `GET /titles/{type}/{id}` — Everything about a movie or series in one request: titles, overviews, ratings, dates, awards, media and cast. - [Cast and crew](https://kinodata.space/en/docs/titles/cast.md): `GET /titles/{type}/{id}/cast` — A title’s actors, dubbing and crew, merged from Kinopoisk, TMDB and Kinorium. - [Media](https://kinodata.space/en/docs/titles/media.md): `GET /titles/{type}/{id}/media` — A title’s posters, stills, logos and videos in one list. - [Texts](https://kinodata.space/en/docs/titles/texts.md): `GET /titles/{type}/{id}/texts` — Facts, questions with answers and quotes about a title. - [Episodes](https://kinodata.space/en/docs/titles/episodes.md): `GET /titles/{type}/{id}/episodes` — A series’ episodes: titles, overviews, air dates, runtime and ratings. - [Related titles](https://kinodata.space/en/docs/titles/relations.md): `GET /titles/{type}/{id}/relations` — Similar titles, the franchise, references to other films and mentions in them. ## People - [Search people](https://kinodata.space/en/docs/persons.md): `GET /persons` — Actors, directors and the whole crew by name in Russian or English. - [Person card](https://kinodata.space/en/docs/persons/card.md): `GET /persons/{type}/{id}` — Who this is: names, dates, photo, biography, family, awards, trivia, roles across the career and best-known titles. - [Filmography](https://kinodata.space/en/docs/persons/filmography.md): `GET /persons/{type}/{id}/filmography` — Every title a person worked on, with their roles, plus the catalog’s filters and sorting. - [Shared titles](https://kinodata.space/en/docs/persons/together.md): `GET /persons/{type}/{id}/with/{type2}/{id2}` — Titles two people both worked on, and what each of them did there. ## Collections and discovery - [Collections](https://kinodata.space/en/docs/collections.md): `GET /collections` — The list of collections: Kinopoisk tops refreshed every day, and editorial picks. - [Collection](https://kinodata.space/en/docs/collections/items.md): `GET /collections/{slug}` — A collection’s titles in the editor’s order, or with the catalog’s filters and sorting. - [Top chart](https://kinodata.space/en/docs/charts/top.md): `GET /charts/top` — The best-rated movies and series above a vote threshold, for rankings and “top 100” lists. - [Hidden gems](https://kinodata.space/en/docs/discover/hidden-gems.md): `GET /discover/hidden-gems` — Highly rated movies and series not that many people know about. - [Rating divergence](https://kinodata.space/en/docs/discover/divergence.md): `GET /discover/divergence` — Titles that Kinopoisk and IMDb rated differently. - [Release calendar](https://kinodata.space/en/docs/releases.md): `GET /releases` — What comes out in theaters and online, and which seasons start, by date and region. ## Values and stats - [Enums](https://kinodata.space/en/docs/enums.md): `GET /enums` — Every closed set of values in the API, labeled in Russian and English, for your types and UI. - [Filter values](https://kinodata.space/en/docs/facets.md): `GET /filters` — Which genres, countries, platforms, tags and companies the database holds and how many titles each has, for dropdowns. - [Database stats](https://kinodata.space/en/docs/meta/stats.md): `GET /meta/stats` — How many titles, people, media, ratings and IDs the database holds, and how complete it is. ## Optional - [The whole documentation in one file](https://kinodata.space/en/llms-full.txt): every page of this index in a row - [Документация на русском](https://kinodata.space/ru/llms.txt): the same documentation in Russian - [Site and pricing](https://kinodata.space/en/pricing): how to get an API key