Rotten Tomatoes search

Search Rotten Tomatoes for movies, TV series, and celebrities.

← All Rotten Tomatoes endpoints · Capability overview

GET/v1/rotten-tomatoes/search

https://api.vee3.io/v1/rotten-tomatoes/search

10 tokens

Search Rotten Tomatoes for movies, TV series, and celebrities.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

search_rotten_tomatoes

Parameters2 fields

querystringRequired

Search query for movies, TV series, or celebrities.

max length 256

limitintegerOptional

Maximum number of search results to return (1–50, default 20).

min 1, max 50

Response7 fields

querystring

Echo of the search query.

moviesarrayitems

5 fields

Search hits (movies, TV series, or celebrities). Each entry includes type, slug, title, url, posterUrl, score, and cast when available.

typestring

Result type (movie, tv, or celebrity).

slugstring

Slug for detail lookups (for example inception or breaking-bad).

titlestring

Display title.

scoreinteger

Tomatometer or list score when available.

scoreSentimentstring

Score sentiment (for example POSITIVE).

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, rotten_tomatoes_not_configured, rotten_tomatoes_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/rotten-tomatoes/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "inception",
    "limit": 20
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample search results for inception.

inception_search.json

{
  "query": "inception",
  "movies": [
    {
      "type": "movie",
      "slug": "inception",
      "url": "https://www.rottentomatoes.com/m/inception",
      "title": "Inception",
      "posterUrl": "https://resizing.flixster.com/0TQV6F2mwi62h39go9Oz44Ki4bg=/fit-in/80x126/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p7825626_p_v10_ae.jpg",
      "releaseYear": "2010",
      "endYear": null,
      "score": 87,
      "scoreSentiment": "POSITIVE",
      "certified": true,
      "cast": [
        "Leonardo DiCaprio",
        "Joseph Gordon-Levitt",
        "Elliot Page"
      ]
    },
    {
      "type": "movie",
      "slug": "invention_of_lying",
      "url": "https://www.rottentomatoes.com/m/invention_of_lying",
      "title": "The Invention of Lying",
      "posterUrl": "https://resizing.flixster.com/9DtRRUi2UfhSq-cWugZfGpsyxr4=/fit-in/80x126/v2/https://resizing.flixster.com/-XZAfHZM39UwaGJIFWKAE8fS0ak=/v3/t/assets/p182956_p_v10_aa.jpg",
      "releaseYear": "2009",
      "endYear": null,
      "score": 56,
      "scoreSentiment": "NEGATIVE",
      "certified": false,
      "cast": [
        "Ricky Gervais",
        "Jennifer Garner",
        "Jonah Hill"
      ]
    }
  ]
}