---
title: "Rotten Tomatoes movie detail"
method: GET
path: "/rottentomatoes/movie"
tags: ["Rotten Tomatoes"]
---

# Rotten Tomatoes movie detail

`GET /rottentomatoes/movie`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/rottentomatoes/movie`
- Auth: API key in header `x-api-key`

Returns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.

## Query parameters

- `path` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesMovieResponseDoc
  - `code` integer
  - `data` RottentomatoesMovieResponse
    - `audience_reviews` RottentomatoesReview[]: Sample of audience reviews shown on the movie page.
      - `display_date` string: Date the review was posted, as shown on the page, such as `Mar 19`.
      - `display_name` string: Display name of the reviewer.
      - `fandango_review` boolean: Whether Rotten Tomatoes flags the review as a Fandango review.
      - `rating` number: Star rating the reviewer gave, such as `5`.
      - `rating_id` string: Unique id of the rating.
      - `rating_range` string: Rating text as shown on the page, such as `Rated 5/5 Stars`.
      - `review` string: Text of the review.
      - `verified` boolean: Whether the review is marked as verified.
    - `audience_score` RottentomatoesScore
      - `average_rating` string: Average rating as shown on the scorecard, such as `8.40`.
      - `banded_rating_count` string: Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
      - `certified` boolean: Whether Rotten Tomatoes marks the score as certified.
      - `liked_count` integer: Number of ratings that liked the title.
      - `not_liked_count` integer: Number of ratings that did not like the title.
      - `rating_count` integer: Number of ratings behind the score.
      - `review_count` integer: Number of reviews behind the score.
      - `reviews_page_url` string: URL of the Rotten Tomatoes page that lists the reviews behind this score.
      - `score` integer: Score as a whole-number percentage.
      - `score_percent` string: Score as text with a percent sign, such as `87%`.
      - `score_type` string: Audience group the score covers, such as `ALL` or `VERIFIED`.
      - `sentiment` string: Overall sentiment of the score, such as `POSITIVE`.
      - `title` string: Name of the score, such as `Tomatometer` or `Popcornmeter`.
    - `cast` RottentomatoesPerson[]: People in the cast of the movie.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `content_rating` string: Content rating of the movie, such as `PG-13`.
    - `critics_score` RottentomatoesScore
      - `average_rating` string: Average rating as shown on the scorecard, such as `8.40`.
      - `banded_rating_count` string: Approximate number of ratings as shown on the page, such as `250,000+ Ratings`.
      - `certified` boolean: Whether Rotten Tomatoes marks the score as certified.
      - `liked_count` integer: Number of ratings that liked the title.
      - `not_liked_count` integer: Number of ratings that did not like the title.
      - `rating_count` integer: Number of ratings behind the score.
      - `review_count` integer: Number of reviews behind the score.
      - `reviews_page_url` string: URL of the Rotten Tomatoes page that lists the reviews behind this score.
      - `score` integer: Score as a whole-number percentage.
      - `score_percent` string: Score as text with a percent sign, such as `87%`.
      - `score_type` string: Audience group the score covers, such as `ALL` or `VERIFIED`.
      - `sentiment` string: Overall sentiment of the score, such as `POSITIVE`.
      - `title` string: Name of the score, such as `Tomatometer` or `Popcornmeter`.
    - `description` string: Short synopsis of the movie.
    - `directors` RottentomatoesPerson[]: Directors of the movie.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `ems_id` string: Rotten Tomatoes' own unique id of the movie.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `genres` string[]: Genres of the movie.
    - `image_url` string: URL of the poster image.
    - `media_type` string: Kind of title, such as `Movie`.
    - `path` string: Rotten Tomatoes path of the movie page, such as `/m/inception`.
    - `producers` RottentomatoesPerson[]: Producers of the movie.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `public_page_derived` boolean: Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
    - `release_date` string: Release date of the movie, such as `2010-07-16`.
    - `reviews_url` string: URL of the Rotten Tomatoes page with the audience reviews of the movie.
    - `source_url` string: URL the data was read from.
    - `title` string: Title of the movie, as Rotten Tomatoes shows it.
    - `url` string: Rotten Tomatoes page URL of the movie.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)