Find Collaborations
find_collaborationsFind who has worked with whom using five collaboration modes, from an actor's frequent partners to shared titles, pairwise matches, and degrees of separation.
Instructions
Who has worked with whom, in five shapes selected by mode.
Answers questions like: "Which actors have worked with Samuel L. Jackson most often?" (collaborators_of, one id), "What films do Jackson and Walken share?" (shared_titles, two ids), "Which two people in this list have appeared together most?" (pairwise, two or more ids), "Who has worked with all five of these people?" (worked_with_all, one or more ids), "How many steps connect these two?" (degrees_of_separation, two ids, at most three hops).
Every mode counts at the unit level, so a series shared across forty episodes counts
once, and every mode honours the credit definition, so "only their films together" is
include_tv_series=false, include_tv_movies=false, include_video=false. limit bounds
the returned collaborators; max_hops bounds the path search.
The hard limit is the data, not the query: IMDb's principal-cast list holds at most 69 people per title, so a shared credit means both people are in that top-billed subset. Its absence is not evidence they never worked together, and a "no path found" result means no path through principal casts within the hop limit. Pass ids, not names; use search_people first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| limit | No | ||
| max_hops | No | ||
| person_ids | No | ||
| credit_definition | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||