Rotten Tomatoes API

Tomatometer and Popcornmeter scores, critics consensus, cast and browse lists from Rotten Tomatoes as JSON.

The API.SH Rotten Tomatoes API returns public Rotten Tomatoes data. Search films, series and people, then open a title for its synopsis, critics consensus, Tomatometer (all and top critics) and Popcornmeter scores, content rating, genres and crew. Pull an actor's or director's filmography with scores, and browse the in theaters, at home, coming soon and TV lists with the site's filters.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Rotten Tomatoes search

GET https://api.api.sh/rottentomatoes/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Rotten Tomatoes API

Score tracking

Record Tomatometer and Popcornmeter for titles over time, including certified flags and review counts.

/title /search

Adding scores to a movie app

Look up a title and show critic and audience scores next to your own data.

/search /title

New release monitoring

Browse what is in theaters, at home or coming soon, sorted and filtered by critic and audience scores.

/browse

Actor and director research

See a person's filmography with each title's scores, plus their highest and lowest rated work.

/person

Entertainment AI assistants

Give an agent the critics consensus and scores to answer which film is worth watching.

/search /title

Rotten Tomatoes data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Rotten Tomatoes API endpoints and prices

Every Rotten Tomatoes endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Rotten Tomatoes search

/rottentomatoes/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

Rotten Tomatoes person

/rottentomatoes/v1/person

$1 · $2 PAYG

1 credit

More data2

Rotten Tomatoes browse /rottentomatoes/v1/browse	$1 · $2 PAYG 1 credit
Rotten Tomatoes movie or TV scores /rottentomatoes/v1/title	$1 · $2 PAYG 1 credit

Call the Rotten Tomatoes API

Rotten Tomatoes search: GET https://api.api.sh/rottentomatoes/v1/search

curl "https://api.api.sh/rottentomatoes/v1/search?q=parasite" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/rottentomatoes/v1/search",
    params={"q": "parasite"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/rottentomatoes/v1/search");
url.searchParams.set("q", "parasite");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/rottentomatoes/v1/search", "q", "parasite")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Rotten Tomatoes" and "Rotten Tomatoes search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Rotten Tomatoes data

Public data only: no Rotten Tomatoes login, cookies or account needed
One key and one response shape for Rotten Tomatoes and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Rotten Tomatoes API

Search results describe Rotten Tomatoes' own API as private or limited, with access by registering a project, and developers often fall back on OMDb for the score. API.SH needs no registration and returns the public scores and details from Rotten Tomatoes pages as JSON.

Skip writing a Rotten Tomatoes scraper or paying for a niche Apify or RapidAPI actor: one API.SH key covers it, and the same format works for other sites.

Rotten Tomatoes API questions

What Rotten Tomatoes data can I get?+

Search for films, series and people (/rottentomatoes/v1/search), a title with scores and consensus (/rottentomatoes/v1/title), a person's page and filmography (/rottentomatoes/v1/person) and browse lists (/rottentomatoes/v1/browse).

How much does the Rotten Tomatoes API cost?+

Every Rotten Tomatoes endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /rottentomatoes/v1/browse at 1 credit each.

Is there an official Rotten Tomatoes API?+

Search results suggest Rotten Tomatoes does not offer an open public API: its own is private or limited, and many projects use OMDb or scrapers. API.SH reads the public pages, so you need no key request or approval.

Do I need a Rotten Tomatoes account or login?+

No. API.SH reads public Rotten Tomatoes pages only. No endpoint uses a login, cookies or anyone's account.

Is there a free Rotten Tomatoes API key?+

There is no key to request with API.SH. You use one API.SH key, and every account gets 1,000 free credits every month.

How do I get a Rotten Tomatoes score from Python?+

Call /rottentomatoes/v1/search with q set to the title to get the Tomatometer, then /rottentomatoes/v1/title with the link for the Popcornmeter, consensus and more. Use requests or the Python SDK.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key from the dashboard. 3. Call /rottentomatoes/v1/title with a Rotten Tomatoes url or path such as /m/avengers_endgame. Docs and every parameter are at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.