Read more of a result that was too large to return in one piece.

Any tool whose answer is too large returns its first page with a paging block. Pass that block's result_id here. Nothing is fetched again: the stored result is paged, filtered and narrowed.

Args: result_id: From the paging block of the earlier answer. offset: First item to return, usually the previous next_offset. limit: At most this many items. Fewer come back if they would not fit. fields: Only these keys of each item. Dots reach nested keys, such as "statistics.sizeOnDisk". The paging.fields list shows what exists. match: Keep only items whose field contains this text, ignoring case, for example {"title": "alien", "year": "1979"}. path: Which list to page when the result holds several, as named in paging.lists. Defaults to the largest.

Find films, series and episodes by name.

Start here to get the tt id every other title tool needs.

Args: query: Title, or part of one. title_type: any, movie or tv. limit: How many matches to return.

Get one title in full: plot, ratings, cast and crew, genres, release, certificate, awards, taglines and poster.

Args: id: Title id such as tt0078748, or an IMDb URL containing one.

List who worked on a title, with characters for the cast.

Args: id: Title id. category: One of director, writer, actor, actress, producer, composer, cinematographer, editor. Omit for everyone, cast first. limit: How many credits per page. cursor: next_cursor from the previous page.

List a series' seasons and episodes with their ratings.

Args: id: The series' title id. season: Only this season. Omit for all, in order. limit: How many episodes per page. cursor: next_cursor from the previous page.

Read user reviews of a title, most helpful first.

Args: id: Title id. limit: How many reviews per page. cursor: next_cursor from the previous page.

Titles IMDb lists as more like this one.

Args: id: Title id. limit: How many to return.

Budget, opening weekend and lifetime grosses by area for a title.

Args: id: Title id.

Find people: actors, directors, writers and crew.

Args: query: Name, or part of one. limit: How many matches to return.

Get one person: biography, dates, professions, known-for titles.

Args: id: Name id such as nm0000244, or an IMDb URL containing one.

A person's filmography, newest first.

Args: id: Name id. category: One of actor, actress, director, writer, producer, composer, cinematographer, editor. Omit for everything. limit: How many credits per page. cursor: next_cursor from the previous page.

Search titles by genre, type, year, rating, vote count and keywords.

This is IMDb's advanced search: "best rated horror films of the 1970s with over 10 000 votes" is one call.

Args: genres: Genre names as IMDb spells them: Horror, Sci-Fi, Film-Noir, Drama. title_types: Any of movie, tvSeries, tvMiniSeries, tvMovie, tvEpisode, short, video, videoGame. year_from: Earliest release year. year_to: Latest release year. min_rating: Lowest IMDb average, 1 to 10. max_rating: Highest IMDb average. min_votes: Fewest votes; 10000 keeps out the obscure. keywords: Plot keywords, all required, such as ["space", "alien"]. text: Words in the title. sort: popularity, rating, votes, release_date, alphabetical, runtime, metascore or box_office. order: ASC or DESC. limit: How many per page. cursor: next_cursor from the previous page.

IMDb's charts: the Top 250, lowest rated, top TV, most popular.

Args: chart: top_rated_movies, lowest_rated_movies, top_rated_tv_shows, top_rated_english_movies, most_popular_movies or most_popular_tv_shows. limit: How many entries per page. cursor: next_cursor from the previous page.

Upcoming releases, soonest first.

Args: kind: movie or tv. from_date: YYYY-MM-DD. Defaults to today. limit: How many per page. cursor: next_cursor from the previous page.

The configured user's own ratings, one page at a time.

For questions over the whole history use find_my_ratings or my_rating_stats.

Args: sort: recent (by date rated) or top (by the rating given). order: DESC or ASC. limit: How many per page, at most 250. cursor: next_cursor from the previous page.

What the configured user rated one title, if anything.

Args: id: Title id, from search_titles.

Search the configured user's whole ratings history.

Every filter is optional and they combine: "my 9s and 10s from the 1990s", "horror I rated below 4", "everything I rated in 2024".

Args: query: Words in the title. year: Release year. year_from: Earliest release year. year_to: Latest release year. rating: Exactly this rating, 1 to 10. min_rating: At least this rating. max_rating: At most this rating. genre: Genre name such as Horror or Comedy. title_type: movie, tvSeries, tvEpisode and so on. rated_from: Earliest date rated, YYYY-MM-DD. rated_to: Latest date rated, YYYY-MM-DD. sort: rated_on, my_rating, imdb_rating, year or title. order: DESC or ASC. limit: How many to return.

Numbers over the configured user's whole ratings history: how many, the average, the spread from 1 to 10, ratings per year, favourite genres and decades, and where they sit against IMDb's averages.

Titles on the configured user's watchlist, in list order.

Args: limit: How many per page. cursor: next_cursor from the previous page.

Any public IMDb list by its ls id, titles or people.

Args: id: List id such as ls055592025, or a URL containing one. limit: How many per page. cursor: next_cursor from the previous page.

Who the configured user is on IMDb, with their ratings and watchlist counts.