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

# Rotten Tomatoes movie reviews

`GET /rottentomatoes/movie/reviews`

## Request

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

Returns critic or audience reviews from Rotten Tomatoes, including pagination metadata. Pass exactly one of `path` or `url`. Supported `type` values are `critics`, `top-critics`, `audience`, and `verified-audience`.

## Query parameters

- `path` string
- `url` string
- `type` 'critics' | 'top-critics' | 'audience' | 'verified-audience'
- `limit` integer
- `after` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesReviewsResponseDoc
  - `code` integer
  - `data` RottentomatoesReviewsResponse
    - `fetched_at` string
    - `limit` integer
    - `movie` RottentomatoesReviewMovieSummary
      - `ems_id` string
      - `media_type` string
      - `path` string
      - `title` string
      - `url` string
    - `page_info` RottentomatoesReviewPageInfo
      - `end_cursor` string: Cursor of the last item on this page. Pass it as `after` to get the next page.
      - `has_next_page` boolean: Whether more items follow this page.
      - `has_previous_page` boolean: Whether items precede this page.
      - `start_cursor` string: Cursor of the first item on this page.
    - `public_page_derived` boolean
    - `reviews` RottentomatoesMovieReview[]
      - `created_at` string
      - `critic_url` string
      - `display_name` string
      - `has_profanity` boolean
      - `has_spoilers` boolean
      - `id` string
      - `original_score` string
      - `publication` string
      - `publication_approved` boolean
      - `publication_review_url` string
      - `rating` number
      - `rating_label` string
      - `review` string
      - `score_sentiment` string
      - `super_reviewer` boolean
      - `tomatometer_approved` boolean
      - `top_critic` boolean
      - `top_publication` boolean
      - `top_review` boolean
      - `type` string
      - `verified` boolean
    - `reviews_api_url` string
    - `source_url` string
    - `type` string
  - `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/028417aa35bb?raw)