Rotten Tomatoes search
Search Rotten Tomatoes for movies, TV series, and celebrities.
← All Rotten Tomatoes endpoints · Capability overview
/v1/rotten-tomatoes/searchhttps://api.vee3.io/v1/rotten-tomatoes/search
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_tomatoesParameters2 fields
querystringRequiredSearch query for movies, TV series, or celebrities.
max length 256
limitintegerOptionalMaximum number of search results to return (1–50, default 20).
min 1, max 50
Response7 fields
querystringEcho of the search query.
moviesarrayitems5 fieldsSearch hits (movies, TV series, or celebrities). Each entry includes type, slug, title, url, posterUrl, score, and cast when available.
moviesarrayitemstypestringResult type (movie, tv, or celebrity).
slugstringSlug for detail lookups (for example inception or breaking-bad).
titlestringDisplay title.
scoreintegerTomatometer or list score when available.
scoreSentimentstringScore sentiment (for example POSITIVE).
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, rotten_tomatoes_not_configured, rotten_tomatoes_upstream_error