Rotten Tomatoes

Rotten Tomatoes movie search

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.

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

Query parameters

querystring required

Search query

limitinteger

Rows to return, default 10, max 20

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "fetched_at": "2026-06-07T14:46:16Z",
    "limit": 10,
    "query": "inception",
    "results": [
      {
        "cast": "Leonardo DiCaprio,Joseph Gordon-Levitt,Elliot Page",
        "certified_fresh": true,
        "path": "/m/inception",
        "release_year": "2010",
        "title": "Inception",
        "tomatometer_score": 87,
        "tomatometer_sentiment": "POSITIVE",
        "url": "https://www.rottentomatoes.com/m/inception"
      }
    ],
    "source_url": "https://www.rottentomatoes.com/search?search=inception"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.