Search
/api/rottentomatoes/search
Search movies and TV with both scores and real paging
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.
Try it now
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.
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"
{
"success": true,
"data": {"items": [{"slug": "the_matrix", "name": "The Matrix", "criticScore": 88}], "count": 1},
"meta": {"endpoint_family": "search", "billable": true, "credits": 1}
}
Structured data for real applications. Here are some ideas.
Find a movie or TV title and read both scores and review counts.
Add consensus, cast, genres, release date and where to watch.
Read the public critic and audience review excerpt with author and outlet.
Rotten Tomatoes scraper API
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.
Search by query and type, then take the slug from the first item.
Open Rotten Tomatoes Search API docsSend that slug with its type to the title route.
Open Rotten Tomatoes Title API docsEverything you need in one API.
/api/rottentomatoes/search
Search movies and TV with both scores and real paging
/api/rottentomatoes/title
Scores, consensus, cast, genres, date and where to watch
/api/rottentomatoes/reviews
Anonymous critic and audience review sample
See how Scrappa compares to Rotten Tomatoes website.
| Feature | Scrappa | Rotten Tomatoes website |
|---|---|---|
| Structured JSON | HTML pages only | |
| Public data access | API key only | No public API |
| Numeric scores | Percent text on the page | |
| Price per 1k requests | From $0.20 | Not available |
| Unified API key | Yes (500+ APIs) | Not available |
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.