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

# Rotten Tomatoes movie search

`GET /rottentomatoes/search`

## Request

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

Searches Rotten Tomatoes movies by the required `query`, returning up to `limit` rows (default 10, max 20). Each row has the title, URL, release year or start and end year, `tomatometer_score` and sentiment, `certified_fresh`, cast and image. No matches returns an empty `results` array.

## Query parameters

- `query` string, required
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesSearchResponseDoc
  - `code` integer
  - `data` RottentomatoesSearchResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of results requested.
    - `query` string: Query that was run.
    - `results` RottentomatoesSearchMovie[]: Titles matching the query.
      - `cast` string: Names of the leading cast, separated by commas.
      - `certified_fresh` boolean: Whether the title is Certified Fresh.
      - `end_year` string: Last year of the title's run, as shown on the search row.
      - `image_url` string: URL of the poster image.
      - `path` string: Rotten Tomatoes path of the title page, such as `/m/inception`.
      - `release_year` string: Release year of the title, such as `2010`.
      - `start_year` string: First year of the title's run, as shown on the search row.
      - `title` string: Title name as shown on the search row.
      - `tomatometer_score` integer: Tomatometer critics score, as a percentage.
      - `tomatometer_sentiment` string: Tomatometer sentiment, such as `POSITIVE`.
      - `url` string: Rotten Tomatoes page URL of the title.
    - `source_url` string: URL the data was read from.
  - `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/afac9b012a27?raw)