Shared titles

GET/v1.3/persons/{type}/{id}/with/{type2}/{id2}

Titles two people both worked on, and what each of them did there.

The two people’s catalogs can differ: /persons/kp/37859/with/imdb/nm0634240 is Leonardo DiCaprio and Christopher Nolan. Each title carries both people’s roles: credits_first for the first person in the path, credits_second for the second.

Roles are set for each person separately. role_first=actor&role_second=director for DiCaprio and Nolan gives exactly Inception: Cobb and the director. role is a role both share: role=actor gives the titles they acted in together, role=self the broadcasts and ceremonies where both were guests. To drop broadcasts and archive footage, exclude those roles: of DiCaprio and Nolan’s 20 shared titles, role.not=self,archive leaves only Inception.

The list runs on the catalog engine: all the filters and sorting work, as do presets, the title search q and fields. Without sort, it runs from newest to oldest; order=asc reverses that. The “English only” example on the right uses this to list the films Keanu Reeves and Laurence Fishburne made together, by IMDb rating, with both people’s roles. The catalog gives the same titles without roles but with a cursor: /titles?person=kp:37859&person=imdb:nm0634240.

If both people in the path are the same person, the response is 400 with a hint to open the filmography.

Path parameters

• typestringrequired

  The catalog the ID of the first person comes from: IMDb, Kinopoisk, TMDB or Kinorium.

  imdbkptmdbkinorium
• idstringrequired

  The ID of the first person in that catalog. IMDb IDs are nm followed by digits (nm0634240); the others are digits (41477).

• type2stringrequired

  The catalog the ID of the second person comes from: IMDb, Kinopoisk, TMDB or Kinorium.

  imdbkptmdbkinorium
• id2stringrequired

  The ID of the second person in that catalog. IMDb IDs are nm followed by digits (nm0634240); the others are digits (41477).

Query parameters

• role_firstcsv

  The first person’s role. Several, comma-separated, mean any of them. role_first.not drops the titles where the person had only such roles.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Example: role_first=actor
• role_secondcsv

  The second person’s role. Several, comma-separated, mean any of them. role_second.not drops the titles where the person had only such roles.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Example: role_second=director
• rolecsv

  A role both of them had. Several, comma-separated, mean any of them. role.not drops the titles where either of them had only such roles.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Example: role=actor
• filters, q and sort

  The catalog’s filters, search and sorting: kind=movie, q=matrix, sort=-rating_imdb. Details in Filters and sorting.

  Default:

  sort=-year

• orderenum

  The direction of the default order: order=asc runs from oldest to newest. When sort is set, its sign decides the direction.

  ascdesc
  Default:

  desc

  Example: order=asc
• fieldscsv

  Which item fields to return, as in the catalog, plus credits_first and credits_second. IDs always come back.

  Example: fields=title,year,credits_first,credits_second
• 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 titles to return, a whole number from 1 to 1000.

  Default:

  1000

  Example: limit=20
• offsetinteger

  How many titles to skip, a whole number from 0.

  Default:

  0

Response fields

• itemsarray

  The shared titles: the same card as in the catalog, with both people’s roles.

  +−Show 26 fields

  • imdb_id · kp_id · tmdb_id · tmdb_tv_id · kinorium_idstring | null

    The title’s catalog IDs. Always returned, even with fields.

  • title_ru · title_en · title_originalstring | null

    Titles: Russian, English and in the original language.

  • yearinteger | null

    Release year.

  • release_datestring | null

    First release date, YYYY-MM-DD.

  • kindenum

    Kind of title: movie, series, mini_series, tv_show, anime, cartoon, short.

  • poster_url_ru · poster_url_enstring | null

    Poster for a Russian and an English storefront.

  • posters_by_sourceobject

    Each source’s poster: kp, tmdb, imdb, kinorium.

  • rating_kp · rating_tmdb · rating_imdb · rating_kr · rating_letterboxdnumber | null

    Kinopoisk, TMDB, IMDb, Kinorium and Letterboxd ratings, 0–10 scale.

  • votes_kp · votes_tmdb · votes_imdbinteger | null

    Kinopoisk, TMDB and IMDb votes.

  • countriesarray

    Countries: code, name_ru, name_en.

  • genresarray

    Genres: slug, name_ru, name_en.

  • credits_first · credits_secondarray

    The first and the second person’s roles on this title, with the same fields as a role in the filmography.

    +−Show 9 fields

    • roleenum

      The role. Labels are in /enums, set credit_roles.

    • character_ru · character_enstring | null

      The character, for actors and dubbing, without the source’s notes, as in the cast. For self, what the person appears as: “Guest”, «гость».

    • job_ru · job_enstring | null

      The crew job: “Executive Producer”, «Исполнительный продюсер».

    • ordinteger | null

      Billing order: for actors, the order in the credits; for the crew, within their department. null when the place is unknown: the role comes from the person’s filmography, not the title’s credits.

    • sourcesarray

      Which catalogs confirmed the credit: kp, tmdb, kinorium, always in this order.

    • uncreditedboolean

      true means the title’s credits don’t name the person: the source marked the part “uncredited” («в титрах не указан»).

    • disputedboolean

      true means only TMDB has the credit, and the title’s Kinopoisk or Kinorium cast doesn’t list the person. The title’s cast leaves such credits out; in a list of work, hide them by checking disputed.

• totalinteger | null

  How many shared titles match the request. null with a q search.

• limit · offset · has_more

  Paging, as in every list.

Errors