Rotten Tomatoes API & Scraper
This API reads rottentomatoes.com, logged out.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`movie`, `tv_series`, `tv_season` and `tv_episode` return the page's Tomatometer (score, review count, fresh and rotten counts, average rating out of 10, Certified Fresh), the Top Critics Tomatometer, the Popcornmeter (score, rating-count band such as "10,000+ Verified Ratings", average stars, Verified Hot) for verified and all audiences, the critics consensus and audience says, the synopsis, every labelled info row (director, producer, screenwriter, distributor, rating with its reasons, genre, original language, theatrical and streaming release dates, US box office, runtime, sound mix, aspect ratio, network), where to watch, cast and crew, and 6 featured critic and 6 featured audience reviews with every field. A series lists its seasons with their own Tomatometer; a season lists its episodes. `reviews` returns up to 40 critic quotes and up to 40 audience reviews per movie or season, merged with the featured reviews. `browse` covers the site's four grids (in theaters, at home, coming soon, TV) with every filter and sort, 30 rows a page. `search`, `search_people`, `autocomplete`, `celebrity`, `filmography`, `critic_search`, `critic`, the critics and publications directories and the editorial guides complete it.
What a Rotten Tomatoes field actually contains
Fields that read differently from how they look. Every row was measured against live rottentomatoes.com pages on 2026-11-16.
| Field | What it holds |
|---|---|
| tomatometer, tomatometer_review_count | The percentage and the review count the page prints under "Tomatometer" (85% and "526 Reviews" for The Batman). Equal to the visible scorecard on 12 of 12 titles (6 movies, 2 series, 4 seasons). |
| popcornmeter, popcornmeter_rating_count_text | The audience score the page shows under "Popcornmeter" and its printed band ("10,000+ Verified Ratings"). Where a verified-audience score exists it is the one shown (popcornmeter_audience: verified); scores.popcornmeter_all_audience holds the all-audience score (The Batman: 87% verified, 85% all). Rotten Tomatoes prints a band, not an exact rating count. |
| certified_fresh, verified_hot | The certified flags of the two score icons on the page. Equal to the page on 24 of 24 checks. |
| top_critics_tomatometer | The Tomatometer of top critics only, with its own review count (The Batman: 76% of 83). |
| scores on a series page | A series page shows "Avg. Tomatometer" and "Avg. Popcornmeter", the average of its seasons; the label field keeps that wording. Season and episode pages carry their own scores. |
| box_office_gross_usa, box_office_gross_usa_usd | The page's "Box Office (Gross USA)" as printed ($369.3M) and the same figure in dollars (369300000). Rotten Tomatoes rounds it to one decimal of a million. |
| reviews: source | list = one of the up to 40 critic quotes or 40 audience reviews the site serves (critic, publication and quote; stars and text); featured = one of the 6 + 6 reviews printed on the page with date, fresh or rotten, original score, top critic flag, full-review link and reviewer; list+featured = both. The Batman: 41 critic rows, 5 of them with the full fields. |
| browse rank and paging | rank is the position in the grid as the site orders it. 30 rows a page; next_cursor continues the list. The at-home grid gave 1,198 rows across 40 pages with no gap or repeat. |
The full paginated review lists (all 526 reviews of The Batman, for example) are not part of this API: it returns the up to 40 + 40 reviews Rotten Tomatoes lists per title plus the featured reviews.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/rotten-tomatoes/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "batman"
}
}{
"ok": true,
"meta": {
"api": "rotten-tomatoes",
"endpoint": "search",
"mode": "live",
"latency_ms": 797,
"record_count": 20,
"bytes": 103384,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "e6270c43766b49bc",
"queue_ms": 1.4,
"fetched_at": "2026-11-16T21:05:26.123Z"
},
"data": {
"query": "batman",
"results": [
{
"ems_id": "60f1eca0-6a51-3cb2-95b6-3ab959ba6e87",
"type": "movie",
"title": "The Batman",
"slug": "the_batman",
"url": "https://www.rottentomatoes.com/m/the_batman",
"path": "/m/the_batman",
"release_year": 2022,
"series_premiere": null,
"series_finale": null,
"rating": "PG-13",
"genres": [
"Action",
"Adventure",
"Crime"
],
"description": "Batman ventures into Gotham City's underworld when a sadistic killer leaves behind a trail of cryptic clues. As the scale of the perpetrator's plans become clear, he must bring justice to the abuse of power and corruption that plagues the metropolis.",
"poster": "https://resizing.flixster.com/HUwAlW1QAya1vlIePUDv3kdzhIE=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzc1OGFlMDI0LTE1ZTEtNDE4ZS04Y2RmLWNjYzcyOWQyZmMyNi5qcGc=",
"studios": [
"Warner Bros. Pictures"
],
"networks": [],
"runtime_minutes": 176,
"tomatometer": 85,
"certified_fresh": true,
"critics_sentiment": "POSITIVE",
"popcornmeter": 87,
"verified_hot": false,
"audience_sentiment": null,
"want_to_see_count": 6999,
"critics_icon": "https://content6.flixster.com/static/images/rt-icons/certifiedfresh.png",
"audience_icon": "https://content6.flixster.com/static/images/rt-icons/red_popcorn.png",
"cast": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"crew": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"titles": [
"The Batman"
],
"aka": [
"Batman"
],
"tms_id": "MV012688620000",
"rt_id": 771504603,
"ems_version_id": "5b7ce760-1aed-344b-9b9e-c00a0ba27d50",
"popularity_score": 959216,
"page_views_popularity": 4157,
"updated": "2026-11-16T21:00:23.684Z",
"other_fields": {
"titleType": "main",
"trailer": {
"mpxId": "[trimmed-depth]",
"thumbnailUrl": "[trimmed-depth]",
"publicId": "[trimmed-depth]",
"title": "[trimmed-depth]",
"runTime": "[trimmed-depth]"
},
"typeId": 1,
"promotion": 0
}
},
{
"ems_id": "f93fd0e2-42cf-3425-86a4-96090ed8ec13",
"type": "movie",
"title": "Batman v Superman: Dawn of Justice",
"slug": "batman_v_superman_dawn_of_justice",
"url": "https://www.rottentomatoes.com/m/batman_v_superman_dawn_of_justice",
"path": "/m/batman_v_superman_dawn_of_justice",
"release_year": 2016,
"series_premiere": null,
"series_finale": null,
"rating": "PG-13",
"genres": [
"Action",
"Adventure",
"Sci-Fi"
],
"description": "It's been nearly two years since Superman's colossal battle with Zod devastated the city of Metropolis. The loss of life and collateral damage left many feeling angry and helpless, including crime-fighting billionaire Bruce Wayne. Convinced that Superman is now a threat to humanity, Batman embarks on a personal vendetta to end his reign on Earth, while the conniving Lex Luthor launches his own crusade against the Man of Steel.",
"poster": "https://resizing.flixster.com/wliboVdo7cDC77pTzTCVk69_s18=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzM2NGE2MDdmLTU2YmYtNDU4ZC1iZGQzLTY4MWE0ZTgyODkyMy53ZWJw",
"studios": [
"Warner Bros."
],
"networks": [],
"runtime_minutes": 153,
"tomatometer": 28,
"certified_fresh": false,
"critics_sentiment": "POSITIVE",
"popcornmeter": 63,
"verified_hot": false,
"audience_sentiment": null,
"want_to_see_count": 104717,
"critics_icon": "https://content6.flixster.com/static/images/rt-icons/rotten.png",
"audience_icon": "https://content6.flixster.com/static/images/rt-icons/red_popcorn.png",
"cast": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"crew": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"titles": [
"Batman v Superman: Dawn of Justice",
"Bat v Sup"
],
"aka": [
"Batman Süperman'a Karsi: Adaletin Safagi",
"Batman Vs. Superman - A Origem da Justiça",
"Batman contra Superman: L'alba de la justícia"
],
"tms_id": "MV006095980000",
"rt_id": 771363115,
"ems_version_id": "a84966df-d6e4-344c-839d-19c54d956542",
"popularity_score": 447969,
"page_views_popularity": 2302,
"updated": "2026-11-16T21:00:20.897Z",
"other_fields": {
"keywords": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
],
"titleType": "main",
"trailer": {
"mpxId": "[trimmed-depth]",
"thumbnailUrl": "[trimmed-depth]",
"publicId": "[trimmed-depth]",
"title": "[trimmed-depth]",
"runTime": "[trimmed-depth]"
},
"typeId": 1,
"promotion": 0
}
},
{
"ems_id": "fc30303e-d38a-32e1-84be-d54eae4f6b29",
"type": "movie",
"title": "Batman: Knightfall - Part 1 - Knightfall",
"slug": "batman_knightfall_part_1_knightfall",
"url": "https://www.rottentomatoes.com/m/batman_knightfall_part_1_knightfall",
"path": "/m/batman_knightfall_part_1_knightfall",
"release_year": 2026,
"series_premiere": null,
"series_finale": null,
"rating": "R",
"genres": [
"Action",
"Adventure",
"Animation"
],
"description": "Arkham Asylum has been destroyed, and all its inmates have been unleashed upon Gotham City. As Batman races to round up some of his greatest enemies, he is pushed to his physical and mental limits and into a final confrontation with a new threat: the man called Bane! Based on the iconic DC comic book event, Batman: Knightfall - Part 1: Knightfall tells the story of the breaking of the Bat.",
"poster": "https://resizing.flixster.com/QnxV6EQenzIrIqaVqrcLS9K9nh0=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzYyODYxYjZlLTA4ZjEtNDJmNS04MGIwLWVjMTQyYmEwNzljNC5qcGc=",
"studios": [],
"networks": [],
"runtime_minutes": 79,
"tomatometer": 92,
"certified_fresh": false,
"critics_sentiment": "POSITIVE",
"popcornmeter": 94,
"verified_hot": false,
"audience_sentiment": null,
"want_to_see_count": 183,
"critics_icon": "https://content6.flixster.com/static/images/rt-icons/fresh.png",
"audience_icon": "https://content6.flixster.com/static/images/rt-icons/red_popcorn.png",
"cast": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"crew": [
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"role": "[trimmed-depth]",
"ems_id": "[trimmed-depth]",
"person_id": "[trimmed-depth]"
}
],
"titles": [
"Batman: Knightfall - Part 1 - Knightfall",
"Batman"
],
"aka": [],
"tms_id": "MV028508870000",
"rt_id": 900122821,
"ems_version_id": "b3f6fbb0-3b59-3afd-a163-318ee75eb99a",
"popularity_score": 954397,
"page_views_popularity": 986,
"updated": "2026-11-16T21:00:25.192Z",
"other_fields": {
"typeId": 1,
"promotion": 0,
"titleType": "main",
"trailer": {
"mpxId": "[trimmed-depth]",
"thumbnailUrl": "[trimmed-depth]",
"publicId": "[trimmed-depth]",
"title": "[trimmed-depth]",
"runTime": "[trimmed-depth]"
}
}
}
],
"count": 20,
"total": 587,
"page": 1,
"page_size": 20,
"total_pages": 30,
"has_more": true,
"filters": "isEmsSearchable = 1"
}
}What the Rotten Tomatoes API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search movies and TV series on Rotten Tomatoes by title (the site's own search index). Each row has the Tomatometer and Popcornmeter, Certified Fresh / Verified Hot, year, age rating, genres, runtime, studios, synopsis, poster, main cast and crew with roles, alternative titles. Filter by type and release-year range; pages of up to 50. The site's search serves the first 1 000 matches of a query (`reachable_rows` says so when there are more). | Content platforms call search to search movies and TV series on Rotten Tomatoes by title (the site's own search index). | query, type, year_min, year_max, page, ... |
| search_people | Search actors, directors and other people on Rotten Tomatoes by name: celebrity slug and URL, number of credits, year of the most recent title, photo. | Research tools call search_people to search actors, directors and other people on Rotten Tomatoes by name. | query, page, page_size |
| autocomplete | Type-ahead suggestions as the site's own search box shows them: titles (movies and TV, with scores) and people for a partial query. | Community analysts call autocomplete to get type-ahead suggestions as the site's own search box shows them. | query, limit |
| critic_search | Search Rotten Tomatoes' directory of critics and publications (27 395 entries: 24 070 critics, 3 325 publications) by name: Tomatometer-approved status, top critic / top publication, current or legacy, country, and for a critic every publication they wrote for. The first 1 000 matches of a query are reachable (`reachable_rows`). | Media monitors call critic_search to search Rotten Tomatoes' directory of critics and publications (27 395 entries. | query, type, designation, page, page_size |
| critic | One critic's Rotten Tomatoes profile by critic slug (the part after /critics/ or /critic/): name, Tomatometer-approved, top critic, current / legacy, country, and every publication with its own approval and designation. | Content platforms call critic to get one critic's Rotten Tomatoes profile by critic slug (the part after /critics/ or /critic/). | critic |
| movie | Everything on a Rotten Tomatoes movie page: Tomatometer (score, average rating out of 10, review count, fresh and rotten counts, Certified Fresh), the Top Critics Tomatometer, the Popcornmeter (verified and all audience, average stars, rating-count band, Verified Hot), critics consensus and audience says, synopsis, every info row (director, producer, screenwriter, distributor, production companies, rating with reasons, genre, original language, theatrical and streaming release dates, US box office, runtime, sound mix, aspect ratio), where to watch, cast & crew, 6 featured critic reviews and 6 featured audience reviews with every field, related titles, photos and editorial links. | Research tools call movie to get everything on a Rotten Tomatoes movie page. | movie |
| tv_series | A TV series page: series Tomatometer and Popcornmeter with counts, synopsis, creator, executive producers, network, rating, genre, language, premiere date, where to watch, cast & crew, and every season with its own Tomatometer, Certified Fresh flag and air date. | Community analysts call tv_series to get a TV series page. | series |
| tv_season | One TV season: Tomatometer and Popcornmeter with counts, critics consensus, every episode (number, title, air date, description, still), featured critic and audience reviews, cast & crew, info rows. | Media monitors call tv_season to get one TV season. | series, season |
| tv_episode | One TV episode: episode Tomatometer (when critics reviewed it), synopsis, air date, director, writers, cast, info rows, neighbouring episodes. | Content platforms call tv_episode to get one TV episode. | series, season, episode |
| ratings | Quick score lookup: give a URL / slug, or a title (optionally year and type) and the best search match is resolved. Returns the Tomatometer and Popcornmeter blocks with their counts, Certified Fresh / Verified Hot and the consensus lines. | Research tools call ratings to get quick score lookup. | url, title, year, type |
| cast | Full cast & crew of a movie, series, season or episode: name, character(s), credit, celebrity slug and URL, photo. | Community analysts call cast to get full cast & crew of a movie, series, season or episode. | url |
| reviews | Critic and audience reviews of a movie, TV season or TV episode, as many as Rotten Tomatoes serves without a sign-in: the site's list of up to 40 critic quotes (critic, publication, quote) and up to 40 audience reviews (stars, text), merged with the 6 + 6 featured reviews that carry every field (date, fresh / rotten, original score, top critic, full-review link, reviewer name, verified ticket buyer, reactions). An episode has only its featured critic cards. Includes both consensus lines and the score counts. | Media monitors call reviews to get critic and audience reviews of a movie, TV season or TV episode, as many as Rotten Tomatoes s…. | url, type |
| videos | Trailers, clips and featurettes of a movie, series or season: title, type, duration, thumbnail, stream URL, video page. | Content platforms call videos to get trailers, clips and featurettes of a movie, series or season. | url |
| photos | The photo gallery of a movie, series, season or celebrity: image URLs in three sizes, caption, aspect ratio, original width and height. | Research tools call photos to get the photo gallery of a movie, series, season or celebrity. | url |
| browse | The Rotten Tomatoes browse grids — movies in theaters, at home (streaming / rent / buy), coming soon, TV series — with every filter the site offers (genre, age rating, Tomatometer status incl. Certified Fresh, Popcornmeter status incl. Verified Hot, streaming service) and every sort (popular, newest, top box office, A-Z, Tomatometer / Popcornmeter high and low). 30 rows per page, cursor paging. | Community analysts call browse to get the Rotten Tomatoes browse grids. | category, genres, ratings, critics, audience, ... |
| box_office | Movies in theaters ranked by box office, as Rotten Tomatoes orders them, with both scores. Same filters as browse (genre, rating, Tomatometer / Popcornmeter status). | Media monitors call box_office to get movies in theaters ranked by box office, as Rotten Tomatoes orders them, with both scores. | genres, ratings, critics, audience, page, ... |
| browse_filters | The browse vocabulary: for each grid, which filters and sort orders it accepts and their values. No upstream request. | Content platforms call browse_filters to get the browse vocabulary. | none |
| home | The Rotten Tomatoes homepage lists (movies in theaters, popular streaming, coming soon, popular TV, …) with each title's scores, plus the editorial spotlight. | Research tools call home to get the Rotten Tomatoes homepage lists (movies in theaters, popular streaming, coming soon, popul…. | none |
| celebrity | A celebrity page: name, photo, highest- and lowest-rated title with Tomatometer, birthday, birthplace, biography, the first 25 movie credits (with scores, roles, characters) and the celebrity id that `filmography` pages with. | Community analysts call celebrity to get a celebrity page. | celebrity |
| filmography | A celebrity's movie or TV credits, 25 per page (the site's own page size), sorted newest, oldest, Tomatometer or Popcornmeter high / low: title, year, credit, character, both scores. | Media monitors call filmography to get a celebrity's movie or TV credits, 25 per page (the site's own page size), sorted newest, old…. | celebrity, celebrity_ems_id, media_type, sort, cursor |
| critics_list | The directory of Tomatometer-approved critics by surname letter: name, critic page, badges (individually approved / top critic), affiliated publications. 100 per page. | Content platforms call critics_list to get the directory of Tomatometer-approved critics by surname letter. | letter, inactive, cursor |
| publications_list | The directory of Tomatometer-approved publications by first letter: name, publication id, approval badge, and for publications approved through individual critics the list of those critics. | Research tools call publications_list to get the directory of Tomatometer-approved publications by first letter. | letter |
| editorial_articles | Rotten Tomatoes editorial articles (news, interviews, rankings), newest first, searchable by keyword: title, date, URL, excerpt, image. | Community analysts call editorial_articles to get rotten Tomatoes editorial articles (news, interviews, rankings), newest first, searchable by…. | query, page, page_size |
| editorial_guides | The list of Rotten Tomatoes ranked guides ("Best Horror Movies of All Time", "… Movies Ranked by Tomatometer"), newest first, searchable: title, URL, slug, date. | Media monitors call editorial_guides to get the list of Rotten Tomatoes ranked guides ("Best Horror Movies of All Time", "… Movies Ranked…. | query, page, page_size |
| editorial_guide | One ranked guide in full: every entry with rank, title, year, Tomatometer, Certified Fresh, Popcornmeter, critics consensus, synopsis, starring and director links. | Content platforms call editorial_guide to get one ranked guide in full. | guide |
Call search from your stack
curl -X POST https://api.reefapi.com/rotten-tomatoes/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"batman"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/rotten-tomatoes/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "batman"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/rotten-tomatoes/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "batman"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.rotten-tomatoes.search with {"query":"batman"}.Who uses this API and why
- Show the Tomatometer, Popcornmeter and their counts next to every title in a catalogue or watch-list app.
- Track Certified Fresh and Verified Hot titles now streaming on Netflix, Prime Video or Max.
- Pull critic quotes and audience reviews with their scores for sentiment research.
- Build season-by-season and episode guides for TV series with their scores.
- Rank an actor's or director's filmography by Tomatometer.
Questions developers ask before integrating
Do I need a Rotten Tomatoes account?
No. Every action reads public rottentomatoes.com pages and the site's own public search, logged out.
Does it return the Tomatometer and Popcornmeter exactly as the page shows them?
Yes. On 12 titles (6 movies, 2 series, 4 seasons) the Tomatometer, its review count, the Popcornmeter, its rating band, Certified Fresh and Verified Hot equalled the visible scorecard on 96 of 96 checks.
How many reviews can I get per movie?
Up to 40 critic quotes and 40 audience reviews per movie or TV season, plus the 6 critic and 6 audience reviews the page features with date, fresh or rotten, original score and link. The full review list beyond that (all 526 critic reviews of The Batman, for example) is not returned.
Can I filter like the site's browse pages?
Yes: in theaters, at home, coming soon and TV, by genre (38), age rating, Tomatometer status (Certified Fresh, fresh, rotten), Popcornmeter status (Verified Hot, upright, spilled), streaming service (12) and 8 sort orders. browse_filters lists which filter each grid accepts.
Does it cover TV seasons and episodes?
Yes. A series returns its seasons with their own Tomatometer and air date, a season returns its episodes with title, air date and description, and every season and episode has its own page with scores, info and cast.
How do I find a title's page?
search (movies and TV, with type and year filters, up to 50 a page), autocomplete, or ratings with a title and year. Every row carries the url and slug that movie, tv_series and the other actions take.
Is box office included?
The US gross the movie page prints ("Box Office (Gross USA)") is in movie; box_office ranks movies in theaters the way Rotten Tomatoes' own top-box-office sort does. Weekend figures are not published on title pages.
Can I look up critics?
critic_search covers the site's directory of 27,395 critics and publications with Tomatometer-approved, top critic and current or legacy status; critic returns one critic's publications. A critic's own review history is not returned.
What is the Rotten Tomatoes API?
Rotten Tomatoes API is a ReefAPI endpoint group for tomatometer and popcornmeter scores with their review counts, certified fresh and verified hot, critic and audience reviews, cast, seasons and episodes, browse filters, search, celebrities, critics and ranked guides from rotten tomatoes. It returns live JSON through POST requests under /rotten-tomatoes/v1.
Is the Rotten Tomatoes API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Rotten Tomatoes calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Rotten Tomatoes login or account?
No login to Rotten Tomatoes is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Rotten Tomatoes data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Rotten Tomatoes API use?
Rotten Tomatoes actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Rotten Tomatoes from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call rotten-tomatoes actions with the same key, credit pool and JSON envelope used by normal REST requests.