Rotten Tomatoes - movie page

v1.0.0

by extracthub Updated 11/14/2026 rottentomatoes.com

Rotten Tomatoes movie page (rottentomatoes.com/m/<movie>): title, release date, Tomatometer (score, certified, sentiment, reviews count, average rating, liked / not liked, top critics score), Popcornmeter audience score (score, ratings count, average rating, all-audience score), critics consensus, audience says, synopsis, content rating, genres, directors, poster, cast (name, role, link, photo) and the Movie Info details (producer, screenwriter, distributor, language, release dates, box office, runtime, ...).

Extractor ID

@1 follows fixes and added fields. to freeze the output.

Try in playground
Price
$0.0025 / request premium Also charged when the request fails after the page was fetched. Pricing
Health
healthy v1.0.0
Request settings
  • GET
  • Proxy
  • No JS rendering
HTML
https://www.rottentomatoes.com/m/oppenheimer_2023
Loading source preview…

What it returns

result.extracted is a JSON object with these top-level fields (from the current configuration; every released version keeps the schema it was released with, see the changes under Versions and health). A sample is in the extracted data panel above.

Field Type
title string
fullTitle string
url string
emsId string
releaseDate string
tomatometer number
tomatometerCertified boolean
tomatometerSentiment string
criticsReviewCount number
criticsAverageRating number
criticsLikedCount number
criticsNotLikedCount number
topCriticsScore number
topCriticsReviewCount number
audienceScore number
audienceRatingCount string
audienceAverageRating number
audienceCertified boolean
audienceSentiment string
allAudienceScore number
allAudienceRatingCount string
criticsConsensus string
audienceSays string
synopsis string
contentRating string
genres string[]
directors string[]
poster string
cast object{image,name,position,role,url}[]
details object{label,values}[]

How to call Rotten Tomatoes - movie page extractor

Pass the URL of a rottentomatoes.com page and this extractor's pinned id. Authenticate every request with your API key in the X-API-Key header (a test key, exth_test_..., returns simulated results at no cost). Every parameter and error code is described in the API reference.

Realtime: one URL, result in the response

GET https://api.extracthub.io/api/extractor/extract

Authentication required via X-API-Key header

Parameter Type Required Description
target_url string Yes The URL to scrape and extract data from
extractor_id string Yes This extractor's ID with a version pin: @extracthub1/rottentomatoes-movie@1. Use @1 for the latest 1.x or @1.2.3 for an exact version.
return_raw_html boolean No Include raw HTML in response (default: false)
async_fallback boolean No Default true: a request still queued after the wait limit becomes an async job (202 with job_id). false: 503 queue_timeout instead
webhook_url string No HTTPS URL notified if the request becomes a job (job.completed / job.failed)

Code examples

curl -X GET "https://api.extracthub.io/api/extractor/extract?target_url=https://example.com&extractor_id=%40extracthub1%2Frottentomatoes-movie%401" \
  -H "X-API-Key: YOUR_API_KEY"

Example response

Shape of a 200 answer (placeholder values). metadata also carries costUsd, and the X-Extractor-Version header names the exact version that ran. With a live API key, X-Credit-Balance gives your credit balance in USD after the request (4 decimals); a 402 body has top_up_url. A busy queue answers 202 with job_id, status_url and result_url; poll GET /api/extractor/jobs/{id} (or cancel it with POST /api/extractor/jobs/{id}/cancel).

{
  "success": true,
  "result": {
    "extracted": {
      "title": "…",
      "fullTitle": "…",
      "url": "…",
      "emsId": "…",
      "releaseDate": "…",
      "tomatometer": 0,
      "tomatometerCertified": false,
      "tomatometerSentiment": "…",
      "criticsReviewCount": 0,
      "criticsAverageRating": 0,
      "criticsLikedCount": 0,
      "criticsNotLikedCount": 0,
      "topCriticsScore": 0,
      "topCriticsReviewCount": 0,
      "audienceScore": 0,
      "audienceRatingCount": "…",
      "audienceAverageRating": 0,
      "audienceCertified": false,
      "audienceSentiment": "…",
      "allAudienceScore": 0,
      "allAudienceRatingCount": "…",
      "criticsConsensus": "…",
      "audienceSays": "…",
      "synopsis": "…",
      "contentRating": "…",
      "genres": [
        "…"
      ],
      "directors": [
        "…"
      ],
      "poster": "…",
      "cast": [
        {
          "position": 0,
          "name": "…",
          "role": "…",
          "url": "…",
          "image": "…"
        }
      ],
      "details": [
        {
          "label": "…",
          "values": [
            "…"
          ]
        }
      ]
    },
    "metadata": {
      "url": "https://example.com",
      "useProxy": true,
      "renderJs": false,
      "scrapedAt": "2026-01-01T12:00:00.000Z"
    }
  }
}

Batch: many URLs in one request

The batch runs in the background with the version resolved once at submission. Read the results as NDJSON pages with a stable cursor; succeeded URLs are charged, and failed URLs only when their scrape reached the provider. If your credit runs out the batch pauses and resumes when credit is available, and POST /api/extractor/batch/{id}/cancel stops it. Signed webhooks report batch.completed, batch.failed and batch.paused.

curl -X POST "https://api.extracthub.io/api/extractor/batch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "extractor_id": "@extracthub1/rottentomatoes-movie@1",
    "targets": [
      { "url": "https://rottentomatoes.com/..." },
      { "url": "https://rottentomatoes.com/..." }
    ],
    "webhook_url": "https://your-app.example/webhooks/extracthub"
  }'

# Progress, then results as NDJSON pages (cursor = last index)
curl "https://api.extracthub.io/api/extractor/batch/BATCH_ID" -H "X-API-Key: YOUR_API_KEY"
curl "https://api.extracthub.io/api/extractor/batch/BATCH_ID/results" -H "X-API-Key: YOUR_API_KEY"

In a pipeline

In the dashboard's pipeline builder, add Rotten Tomatoes - movie page as an extractor node and set its version pin to 1 (or exactly 1.0.0). A previous node can feed it the URLs it extracts; pipelines run manually or on a cron schedule, report progress live and export JSON, CSV or NDJSON.

With an AI agent (MCP)

Connect Claude Code, Claude Desktop or Cursor to the ExtractHub MCP server (https://api.extracthub.io/mcp, your API key as a Bearer token) and ask in plain language. The agent calls extract with this extractor's pinned id, or create_batch for many URLs, at the same price and limits as the API. Use a test key to try it without credit. Set up the MCP server.

Ask your agent
Use ExtractHub to extract https://rottentomatoes.com/... with @extracthub1/rottentomatoes-movie@1
Tool call it makes
{
  "tool": "extract",
  "arguments": {
    "extractor_id": "@extracthub1/rottentomatoes-movie@1",
    "url": "https://rottentomatoes.com/..."
  }
}

Versions and health

Each version is immutable. @N resolves to the newest non-yanked version of major N; a deprecated major keeps working until its sunset date and its responses carry Deprecation and Sunset headers. Health comes from scheduled checks of the released versions.

@1
latest 1.0.0
active healthy
  1. v1.0.0 active healthy Released 11/14/2026

Rotten Tomatoes - movie page extractor: frequently asked questions

Is Rotten Tomatoes - movie page extractor a rottentomatoes.com scraper?

Yes. Rotten Tomatoes - movie page is an ExtractHub extractor: a saved, versioned web scraper for rottentomatoes.com pages that returns the page as structured JSON. Call it as a rottentomatoes.com scraper API with extractor_id=@extracthub1/rottentomatoes-movie@1; it never changes under you, because every released version is immutable.

What data does Rotten Tomatoes - movie page extractor return?

It returns a JSON object with 30 top-level fields: title (string), fullTitle (string), url (string), emsId (string), releaseDate (string), tomatometer (number), tomatometerCertified (boolean), tomatometerSentiment (string), criticsReviewCount (number), criticsAverageRating (number), criticsLikedCount (number), criticsNotLikedCount (number), topCriticsScore (number), topCriticsReviewCount (number), audienceScore (number), audienceRatingCount (string), audienceAverageRating (number), audienceCertified (boolean), audienceSentiment (string), allAudienceScore (number), allAudienceRatingCount (string), criticsConsensus (string), audienceSays (string), synopsis (string), contentRating (string), genres (string[]), directors (string[]), poster (string), cast (object{image,name,position,role,url}[]) and details (object{label,values}[]). The extracted data panel on this page shows a sample.

How do I call Rotten Tomatoes - movie page extractor?

Send GET or POST https://api.extracthub.io/api/extractor/extract with your API key in the X-API-Key header, extractor_id=@extracthub1/rottentomatoes-movie@1 and the URL of a rottentomatoes.com page as the target. For many URLs use POST https://api.extracthub.io/api/extractor/batch, and in a pipeline add it as an extractor node pinned to 1.

Can an AI agent use Rotten Tomatoes - movie page extractor?

Yes. Connect Claude Code, Claude Desktop, Cursor or another MCP client to the ExtractHub MCP server at https://api.extracthub.io/mcp with your API key, then ask it to extract a rottentomatoes.com page: the agent calls the extract tool with extractor_id=@extracthub1/rottentomatoes-movie@1 (or create_batch for many URLs), at the same price as the API.

Which version should I pin?

Pin the major (@extracthub1/rottentomatoes-movie@1) to receive fixes and added fields automatically, or the exact version (@extracthub1/rottentomatoes-movie@1.0.0) to freeze the output. A breaking schema change is always released as a new major, so a major pin never loses or retypes a field.

Does it render JavaScript or use a proxy?

No, it fetches the HTML without JavaScript rendering and it goes through a proxy. Calls are charged at the premium tier (through the scraping proxy, no JavaScript). These settings are part of each released version; JavaScript rendering, XHR capture and browser actions always use the proxy.

More web scrapers in the scraper catalog and in Entertainment.