Movie & TV Search — Ratings, cast & episode guides

Tools / Movie & TV Search

Search movies and TV shows by name. Returns a list of results with title, year, IMDB ID, type, and poster image.

Returns: List of matching results with title, year, imdb_id, type, and poster_url

Parameters

query *stringMovie or TV show name to search for

typestringFilter by type — movie, series, or any (all results)

yearnumberFilter by release year

Example

Search for Inception

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "movie-tv-search",
  "skill": "search",
  "input": {
    "query": "Inception"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Details

Get full details for a movie or TV show including ratings from IMDB, Rotten Tomatoes, and Metacritic, plus cast, director, plot, awards, and box office data.

Returns: Title, year, runtime, genre, director, actors, plot, awards, poster, ratings (IMDB/RT/Metacritic), box office, total seasons

Parameters

titlestringMovie or TV show title to look up

imdb_idstringIMDB ID like tt1375666 for direct lookup

plotstringPlot summary length — short or full

Example

Get details for Inception by title

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "movie-tv-search",
  "skill": "get_details",
  "input": {
    "title": "Inception"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Episodes

Get the episode list for a specific season of a TV show. Returns episode titles, air dates, and IMDB ratings for each episode.

Returns: List of episodes with title, episode number, released date, imdb_rating, and imdb_id

Parameters

title *stringTV show title

season *numberSeason number

Example

Get Breaking Bad season 1 episodes

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "movie-tv-search",
  "skill": "get_episodes",
  "input": {
    "title": "Breaking Bad",
    "season": 1
  }
}' \
  https://api.toolrouter.com/v1/tools/call

TV Show Cast

Get the full cast of a TV show with actor names and character names.

Returns: Cast list with actor name, character name, and actor image URL

Parameters

query *stringTV show name to look up cast for

Example

Get the cast of Breaking Bad

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "movie-tv-search",
  "skill": "tv_show_cast",
  "input": {
    "query": "Breaking Bad"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

TV Episodes Detailed

Get detailed episodes with ratings and summaries for a TV show, grouped by season.

Returns: All episodes with season, episode number, name, airdate, rating, and summary

Parameters

query *stringTV show name to get episodes for

Example

Get all Game of Thrones episodes with ratings

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "movie-tv-search",
  "skill": "tv_episodes_detailed",
  "input": {
    "query": "Game of Thrones"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"movie-tv-search","skill":"search","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Use Cases

Open Find Movies by Genre

Find Movies by Genre

Search for movies within a specific genre to find your next watch based on the type of movie you are in the mood for.

Movie & TV Search4 agent guides

Open Search by Streaming Platform

Search by Streaming Platform

Find movies and shows available on specific streaming services to make the most of your subscriptions.

Movie & TV Search4 agent guides

Open Search Papers by Topic

Search Papers by Topic

Find relevant academic papers on any research topic across millions of scholarly publications.

Academic Research4 agent guides

Open Geocode Addresses to Coordinates

Geocode Addresses to Coordinates

Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.

Address Geocoding4 agent guides

View all use cases for Movie & TV Search→

Frequently Asked Questions

How do I find the right movie or show if I only know the name?

Start with `search` to get matching titles and IMDB IDs, then use `get_details` for the exact one you want. You can also filter search by movie, series, or year.

What extra details do I get from a title lookup?

`get_details` returns ratings from IMDB, Rotten Tomatoes, and Metacritic, plus cast, director, plot, awards, box office, and total seasons when the title is a series.

Can I pull episode lists for a TV show?

Yes. Use `get_episodes` for one season at a time, or `tv_episodes_detailed` to get every season in one pass with ratings and summaries.

Can I search by movie type or release year?

Yes. The `search` tool accepts `movie`, `series`, or `any`, and you can narrow results by year when you already know the release date.