Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Rotten Tomatoes API page →
Media, Film & Knowledge

Rotten Tomatoes API & Scraper

This API reads rottentomatoes.com, logged out.

25 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Reference

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.

FieldWhat it holds
tomatometer, tomatometer_review_countThe 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_textThe 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_hotThe certified flags of the two score icons on the page. Equal to the page on 24 of 24 checks.
top_critics_tomatometerThe Tomatometer of top critics only, with its own review count (The Batman: 76% of 83).
scores on a series pageA 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_usdThe 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: sourcelist = 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 pagingrank 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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/rotten-tomatoes/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "batman"
  }
}
Captured response
{
  "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"
  }
}
Actions

What the Rotten Tomatoes API does

ActionDescriptionConcrete use caseKey params
searchSearch 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_peopleSearch 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
autocompleteType-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_searchSearch 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
criticOne 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
movieEverything 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_seriesA 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_seasonOne 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_episodeOne 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
ratingsQuick 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
castFull 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
reviewsCritic 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
videosTrailers, 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
photosThe 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
browseThe 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_officeMovies 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_filtersThe 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
homeThe 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
celebrityA 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
filmographyA 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_listThe 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_listThe 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_articlesRotten 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_guidesThe 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_guideOne 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.rotten-tomatoes.search with {"query":"batman"}.
Use cases

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.
FAQ

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.

docs / rotten-tomatoes

Rotten Tomatoes

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.

base /rotten-tomatoes/v125 endpoints
post/rotten-tomatoes/v1/search_people1 credit

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.

ParameterAllowed / rangeDescription
queryrequired—Name words.
page = 1optional1–100Result page.
page_size = 20optional1–50Rows per page.
Try in playground →
post/rotten-tomatoes/v1/autocomplete1 credit

Type-ahead suggestions as the site's own search box shows them: titles (movies and TV, with scores) and people for a partial query.

ParameterAllowed / rangeDescription
queryrequired—Partial text.
limit = 5optional1–20Suggestions per group (the site shows 5).
Try in playground →
post/rotten-tomatoes/v1/critic1 credit

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.

ParameterAllowed / rangeDescription
criticrequired—Critic slug (`manohla-dargis`) or a critic URL (`critic_url` of a review row, `url` of critics_list / critic_search).
Try in playground →
post/rotten-tomatoes/v1/movie1 credit

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.

ParameterAllowed / rangeDescription
movierequired—The movie: its Rotten Tomatoes slug (`the_batman`), path (`/m/the_batman`) or full URL. `slug` / `url` of a search, browse or filmography row.
Try in playground →
post/rotten-tomatoes/v1/tv_series1 credit

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.

ParameterAllowed / rangeDescription
seriesrequired—The TV series: slug (`the_bear`), path (`/tv/the_bear`) or full URL. A season or episode URL is also accepted (its series part is used, or season/episode are read from it).
Try in playground →
post/rotten-tomatoes/v1/tv_season1 credit

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.

ParameterAllowed / rangeDescription
seriesrequired—The TV series: slug (`the_bear`), path (`/tv/the_bear`) or full URL. A season or episode URL is also accepted (its series part is used, or season/episode are read from it).
seasonrequired0–200Season number (1 = /s01).
Try in playground →
post/rotten-tomatoes/v1/tv_episode1 credit

One TV episode: episode Tomatometer (when critics reviewed it), synopsis, air date, director, writers, cast, info rows, neighbouring episodes.

ParameterAllowed / rangeDescription
seriesrequired—The TV series: slug (`the_bear`), path (`/tv/the_bear`) or full URL. A season or episode URL is also accepted (its series part is used, or season/episode are read from it).
seasonrequired0–200Season number (1 = /s01).
episoderequired0–999Episode number (1 = /e01).
Try in playground →
post/rotten-tomatoes/v1/ratings2 credits

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.

ParameterAllowed / rangeDescription
urloptional—Movie or TV page URL / path (`/m/…`, `/tv/…`, `/tv/…/s01`).
titleoptional—Title to look up when no URL is given.
yearoptional1870–2100Release year to pick the right title.
type = alloptionalall · movie · tvRestrict the title lookup.
Try in playground →
post/rotten-tomatoes/v1/cast1 credit

Full cast & crew of a movie, series, season or episode: name, character(s), credit, celebrity slug and URL, photo.

ParameterAllowed / rangeDescription
urlrequired—Movie or TV page: `/m/<slug>`, `/tv/<slug>`, `/tv/<slug>/s01` or `/tv/<slug>/s01/e01` (path or full URL). A bare slug is read as a movie.
Try in playground →
post/rotten-tomatoes/v1/reviews2 credits

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.

ParameterAllowed / rangeDescription
urlrequired—Movie (`/m/<slug>`), TV season (`/tv/<slug>/s01`) or episode (`/tv/<slug>/s01/e01`) page; a bare slug is a movie.
type = alloptionalall · critics · audienceWhich reviews.
Try in playground →
post/rotten-tomatoes/v1/videos1 credit

Trailers, clips and featurettes of a movie, series or season: title, type, duration, thumbnail, stream URL, video page.

ParameterAllowed / rangeDescription
urlrequired—Movie or TV page: `/m/<slug>`, `/tv/<slug>`, `/tv/<slug>/s01` or `/tv/<slug>/s01/e01` (path or full URL). A bare slug is read as a movie.
Try in playground →
post/rotten-tomatoes/v1/photos1 credit

The photo gallery of a movie, series, season or celebrity: image URLs in three sizes, caption, aspect ratio, original width and height.

ParameterAllowed / rangeDescription
urlrequired—`/m/<slug>`, `/tv/<slug>`, `/tv/<slug>/s01` or `/celebrity/<slug>` (path or full URL).
Try in playground →
post/rotten-tomatoes/v1/browse1 credit

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.

ParameterAllowed / rangeDescription
category = movies_in_theatersoptionalmovies_in_theaters · movies_at_home · movies_coming_soon · tv_series_browseWhich browse grid.
genresoptional—Genres (any of): action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, lgbtq, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.
ratingsoptional—Age ratings (any of). Movies: g, pg, pg_13, r, nc_17, nr, ur. TV: tvy, tvy7, tvg, tvpg, tv14, tvma.
criticsoptional—Tomatometer status (any of): certified_fresh, fresh, rotten (TV: fresh, rotten).
audienceoptional—Popcornmeter status (any of): verified_hot, upright, spilled (TV: upright, spilled; not offered on movies_coming_soon).
affiliatesoptional—Where to watch (any of; movies_at_home and tv_series_browse only): fandango, apple-tv-plus, netflix, prime-video, disney-plus, max, peacock, hulu, paramount-plus, amc-plus, acorn-tv, apple-tv.
sortoptionalpopular · newest · top_box_office · a_z · critic_highest · critic_lowest · audience_highest · audience_lowestOrder. Not every grid offers every order: top_box_office only on movies_in_theaters; audience_* not on movies_coming_soon.
page = 1optional1–100Page of 30 rows (the site's page size).
cursoroptional—`next_cursor` of the previous call (takes precedence over `page`).
Try in playground →
post/rotten-tomatoes/v1/box_office1 credit

Movies in theaters ranked by box office, as Rotten Tomatoes orders them, with both scores. Same filters as browse (genre, rating, Tomatometer / Popcornmeter status).

ParameterAllowed / rangeDescription
genresoptional—Genres (any of): action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, lgbtq, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western.
ratingsoptional—Age ratings (any of). Movies: g, pg, pg_13, r, nc_17, nr, ur. TV: tvy, tvy7, tvg, tvpg, tv14, tvma.
criticsoptional—Tomatometer status (any of): certified_fresh, fresh, rotten (TV: fresh, rotten).
audienceoptional—Popcornmeter status (any of): verified_hot, upright, spilled (TV: upright, spilled; not offered on movies_coming_soon).
page = 1optional1–100Page of 30 rows (the site's page size).
cursoroptional—`next_cursor` of the previous call (takes precedence over `page`).
Try in playground →
post/rotten-tomatoes/v1/browse_filtersfree

The browse vocabulary: for each grid, which filters and sort orders it accepts and their values. No upstream request.

Try in playground →
post/rotten-tomatoes/v1/home1 credit

The Rotten Tomatoes homepage lists (movies in theaters, popular streaming, coming soon, popular TV, …) with each title's scores, plus the editorial spotlight.

Try in playground →
post/rotten-tomatoes/v1/celebrity1 credit

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.

ParameterAllowed / rangeDescription
celebrityrequired—Celebrity slug (`cillian_murphy`), path or URL — `slug` of a search_people row.
Try in playground →
post/rotten-tomatoes/v1/filmography2 credits

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.

ParameterAllowed / rangeDescription
celebrityoptional—Celebrity slug / path / URL (costs one extra request to read the celebrity id; pass `celebrity_ems_id` to skip it).
celebrity_ems_idoptional—`celebrity_ems_id` from `celebrity` or `ems_id` of search_people.
media_type = movieoptionalmovie · tvMovie or TV credits.
sort = newestoptionalnewest · oldest · critic_highest · critic_lowest · audience_highest · audience_lowestOrder.
cursoroptional—`next_cursor` of the previous call.
Try in playground →
post/rotten-tomatoes/v1/critics_list1 credit

The directory of Tomatometer-approved critics by surname letter: name, critic page, badges (individually approved / top critic), affiliated publications. 100 per page.

ParameterAllowed / rangeDescription
letterrequireda · b · c · d · e · f · g · h · i · j · k · l · m · n · o · p · q · r · s · t · u · v · w · x · y · zSurname initial a-z.
inactive = falseoptional—The site's list of inactive (legacy) critics instead of active ones.
cursoroptional—`next_cursor` of the previous call.
Try in playground →
post/rotten-tomatoes/v1/publications_list1 credit

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.

ParameterAllowed / rangeDescription
letterrequireda · b · c · d · e · f · g · h · i · j · k · l · m · n · o · p · q · r · s · t · u · v · w · x · y · zFirst letter a-z.
Try in playground →
post/rotten-tomatoes/v1/editorial_articles1 credit

Rotten Tomatoes editorial articles (news, interviews, rankings), newest first, searchable by keyword: title, date, URL, excerpt, image.

ParameterAllowed / rangeDescription
queryoptional—Keyword (optional).
page = 1optional1–500Page.
page_size = 20optional1–100Rows per page.
Try in playground →
post/rotten-tomatoes/v1/editorial_guides1 credit

The list of Rotten Tomatoes ranked guides ("Best Horror Movies of All Time", "… Movies Ranked by Tomatometer"), newest first, searchable: title, URL, slug, date.

ParameterAllowed / rangeDescription
queryoptional—Keyword (optional).
page = 1optional1–500Page.
page_size = 20optional1–100Rows per page.
Try in playground →
post/rotten-tomatoes/v1/editorial_guide1 credit

One ranked guide in full: every entry with rank, title, year, Tomatometer, Certified Fresh, Popcornmeter, critics consensus, synopsis, starring and director links.

ParameterAllowed / rangeDescription
guiderequired—Guide slug or URL (`slug` / `url` of editorial_guides).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.