Rotten Tomatoes API

Rotten Tomatoes API for Movie and TV Scores and Reviews

Scrappa's Rotten Tomatoes API returns public movie and TV Tomatometer and audience scores as JSON. Search titles, read full title detail with consensus, cast, genres, date and where to watch, and read the anonymous critic and audience review sample. Only public logged-out data is returned. Scrappa is independent and not affiliated with Rotten Tomatoes.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
3
Endpoints
2
Title types
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/rottentomatoes/search?query=matrix&type=movie&page=1" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": {"items": [{"slug": "the_matrix", "name": "The Matrix", "criticScore": 88}], "count": 1},
  "meta": {"endpoint_family": "search", "billable": true, "credits": 1}
}

What you can build

Structured data for real applications. Here are some ideas.

Score lookup

Find a movie or TV title and read both scores and review counts.

Catalog enrichment

Add consensus, cast, genres, release date and where to watch.

Review sample

Read the public critic and audience review excerpt with author and outlet.

Rotten Tomatoes scraper API

Tomatometer and audience scores as JSON

Search returns the slug and type you pass unchanged to title and reviews. Percent strings such as 74% are parsed to the number 74. Dates are ISO 8601 and poster URLs are full size.

Search movies and TV with a type filter and a real index page number.

Title detail carries both scores, consensus, cast and where to watch.

Reviews return the anonymous sample the site serves publicly.

Failed requests and empty results are never charged.

Choose the right Rotten Tomatoes API endpoint

Find a slug

Search by query and type, then take the slug from the first item.

Open Rotten Tomatoes Search API docs

Read the detail

Send that slug with its type to the title route.

Open Rotten Tomatoes Title API docs

Available endpoints

Everything you need in one API.

Scrappa vs Rotten Tomatoes website

See how Scrappa compares to Rotten Tomatoes website.

Structured JSON
Scrappa
Rotten Tomatoes website
HTML pages only
Public data access
Scrappa
API key only
Rotten Tomatoes website
No public API
Numeric scores
Scrappa
Rotten Tomatoes website
Percent text on the page
Price per 1k requests
Scrappa
From $0.20
Rotten Tomatoes website
Not available
Unified API key
Scrappa
Yes (500+ APIs)
Rotten Tomatoes website
Not available

Key features

Movie and TV search with a type filter
Tomatometer and audience scores parsed to numbers
Consensus, cast, genres, date and where to watch
Anonymous critic and audience review sample
Failed and empty requests are not charged
One API key with 500 free credits per month

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Rotten Tomatoes.

Rotten Tomatoes serves a public sample of about six critic and six audience reviews. The full archive needs a login and is not offered.

The slug returned by search. Pass the type as well to resolve the media in one lookup.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit. Failed requests are never charged.

Start using the Rotten Tomatoes API

Sign up and get 500 free credits. No credit card required.