Texts

GET/v1.3/titles/{type}/{id}/texts

Facts, questions with answers and quotes about a title.

Without parameters the texts come split into sections: facts, questions and answers, quotes. counts is how many texts of each kind the title has, with any kind: label your tabs with it.

Texts are in Russian only for now: the _en fields are null. With lang=en the text comes back empty, which shows there is no translation yet.

On The Matrix, one fact in four gives the plot away. To show facts next to the overview, drop the spoilers: spoilers=false.

Path parameters

typestringrequired
The catalog the ID comes from: IMDb, Kinopoisk, TMDB (movie or series) or Kinorium.
imdbkptmdbtmdb_tvkinorium
idstringrequired
The ID in that catalog. IMDb IDs are tt followed by digits (tt1375666); the others are digits (447301).

Query parameters

kindcsv
Kinds of text, comma-separated. Labels are in /enums, set text_kinds.
factfaqquote
Default:
all three
Example: kind=quote
spoilersboolean
false drops facts that give the plot away.
Default:
with spoilers
Example: spoilers=false
fact_kindcsv
Fact subtypes, comma-separated. Labels are in /enums, set fact_kinds.
generaltriviablooper
Example: fact_kind=blooper
groupenum
Split the list into sections. none gives a flat list. How sections work is in Lists and pagination.
kindnone
Default:
kind
langru | en
Keep one language in the response. Without it, text fields come in _ru and _en pairs. More in Response languages.
Example: lang=en
limitinteger
How many items to return, a whole number from 1. With sections, per section, up to 50. In a flat list, up to 1000. Above the cap isn’t an error: the API lowers it and shows the value in limit.
Default:
10 per section, 1000 in a flat list
Example: limit=20
offsetinteger
How many items to skip, a whole number from 0. Only in a flat list: with sections it returns 400.
Default:
0

Response fields

countsobject
How many facts, questions and quotes the title has: fact, faq, quote.
itemsarray
The texts. Fields depend on the kind, kind. With sections, sections with their own total and labels.
Show 17 fields
- kindenum
  Kind: fact, faq or quote.
- text_ru · text_enstring | null
  The fact or the quote.
- fact_kindenum
  Fact subtype: general, trivia or blooper.
- is_spoilerboolean
  The fact gives the plot away. false means the source didn’t mark it so.
- ordinteger
  The fact’s order at the source.
- question_ru · question_en · answer_ru · answer_enstring | null
  The question and the answer.
- linksarray
  Who the answer mentions: text as written, type, and IDs with a name, as for a person in the cast.
- original · original_langstring | null
  The quote in the original language, and that language as ISO 639-1.
- author_ru · author_enstring | null
  Who says the quote: the actor.
- author_role_ru · author_role_enstring | null
  The character the quote belongs to.
total · limit · offset · has_more
Paging, as in every list.

Errors

status	code	when
400	invalid_request	An unknown `kind`, `fact_kind` or `group`; `offset` together with sections; a parameter this list doesn’t understand (such as `sort` or `fields`); the response lists the allowed ones.
404	not_found	No title found for this ID.
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 page.