Rotten Tomatoes API endpoint
Returns Rotten Tomatoes celebrity/person metadata and filmography rows. Pass exactly one of `path` or `url`.
/rottentomatoes/personQuery parameters:
path: Rotten Tomatoes person path, for example /celebrity/christopher_nolan.url: absolute https://www.rottentomatoes.com person URL.Notable response behavior:
data.public_page_derived is true.highest_rated and lowest_rated are included only when the public bio
panel exposes those title links and scores.filmography rows prefer the embedded filmography module because it includes
credits plus critic and audience score summaries.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| position | 24 | 1 to 24, median 12 |
| title | 24 | |
| path | 24 | |
| url | 24 | rottentomatoes.com |
| poster_url | 23 | resizing.flixster.com |
| years_featured | 24 | 1,997 to 2,026, median 2,014 |
| credits | 24 | |
| critics_score | 19 | |
| audience_score | 23 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| path | string | No | Rotten Tomatoes person path | /celebrity/christopher_nolan | |
| url | string | No | Absolute https://www.rottentomatoes.com person URL | https://www.rottentomatoes.com/celebrity/christopher_nolan | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/person" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"name": "Christopher Nolan",
"path": "/celebrity/christopher_nolan",
"url": "https://www.rottentomatoes.com/celebrity/christopher_nolan",
"ems_id": "a015d515-713e-38e3-abbe-cf0cdaa519b0",
"birth_date": "1970-07-30",
"birthplace": "London, England, UK",
"highest_rated": {
"title": "The Dark Knight",
"path": "/m/the_dark_knight",
"score": 94,
"year": "2008"
},
"filmography": [
{
"title": "Oppenheimer",
"path": "/m/oppenheimer_2023",
"credits": "Director, Screenwriter, Producer",
"critics_score": {
"score_percent": "93%"
}
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/rottentomatoes.personResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | rottentomatoes.PersonResponse | No | ||||
| data.birth_date | string | No | 1970-07-30 | Date of birth, such as `1970-07-30`. | ||
| data.birthplace | string | No | London, England, UK | Place of birth, such as `London, England, UK`. | ||
| data.description | string | No | Biography text of the person. | |||
| data.ems_id | string | No | a015d515-713e-38e3-abbe-cf0cdaa519b0 | Rotten Tomatoes' own unique id of the person. | ||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.filmography | array | No | Titles the person has credits on, one entry per title. | |||
| data.filmography[].audience_score | object | No | Popcornmeter audience score of the title. | |||
| data.filmography[].audience_score.average_rating | string | No | 8.40 | Average rating as shown on the scorecard, such as `8.40`. | ||
| data.filmography[].audience_score.banded_rating_count | string | No | 250,000+ Ratings | Approximate number of ratings as shown on the page, such as `250,000+ Ratings`. | ||
| data.filmography[].audience_score.certified | boolean | No | true | Whether Rotten Tomatoes marks the score as certified. | ||
| data.filmography[].audience_score.liked_count | integer | No | 314 | Number of ratings that liked the title. | ||
| data.filmography[].audience_score.not_liked_count | integer | No | 49 | Number of ratings that did not like the title. | ||
| data.filmography[].audience_score.rating_count | integer | No | 363 | Number of ratings behind the score. | ||
| data.filmography[].audience_score.review_count | integer | No | 363 | Number of reviews behind the score. | ||
| data.filmography[].audience_score.reviews_page_url | string | No | https://www.rottentomatoes.com/m/inception/reviews | URL of the Rotten Tomatoes page that lists the reviews behind this score. | ||
| data.filmography[].audience_score.score | integer | No | 87 | Score as a whole-number percentage. | ||
| data.filmography[].audience_score.score_percent | string | No | 87% | Score as text with a percent sign, such as `87%`. | ||
| data.filmography[].audience_score.score_type | string | No | ALL | Audience group the score covers, such as `ALL` or `VERIFIED`. | ||
| data.filmography[].audience_score.sentiment | string | No | POSITIVE | Overall sentiment of the score, such as `POSITIVE`. | ||
| data.filmography[].audience_score.title | string | No | Tomatometer | Name of the score, such as `Tomatometer` or `Popcornmeter`. | ||
| data.filmography[].credits | string | No | Director, Screenwriter, Producer | Roles the person had on the title, such as `Director, Screenwriter, Producer`. | ||
| data.filmography[].critics_score | object | No | Tomatometer critics score of the title. | |||
| data.filmography[].critics_score.average_rating | string | No | 8.40 | Average rating as shown on the scorecard, such as `8.40`. | ||
| data.filmography[].critics_score.banded_rating_count | string | No | 250,000+ Ratings | Approximate number of ratings as shown on the page, such as `250,000+ Ratings`. | ||
| data.filmography[].critics_score.certified | boolean | No | true | Whether Rotten Tomatoes marks the score as certified. | ||
| data.filmography[].critics_score.liked_count | integer | No | 314 | Number of ratings that liked the title. | ||
| data.filmography[].critics_score.not_liked_count | integer | No | 49 | Number of ratings that did not like the title. | ||
| data.filmography[].critics_score.rating_count | integer | No | 363 | Number of ratings behind the score. | ||
| data.filmography[].critics_score.review_count | integer | No | 363 | Number of reviews behind the score. | ||
| data.filmography[].critics_score.reviews_page_url | string | No | https://www.rottentomatoes.com/m/inception/reviews | URL of the Rotten Tomatoes page that lists the reviews behind this score. | ||
| data.filmography[].critics_score.score | integer | No | 87 | Score as a whole-number percentage. | ||
| data.filmography[].critics_score.score_percent | string | No | 87% | Score as text with a percent sign, such as `87%`. | ||
| data.filmography[].critics_score.score_type | string | No | ALL | Audience group the score covers, such as `ALL` or `VERIFIED`. | ||
| data.filmography[].critics_score.sentiment | string | No | POSITIVE | Overall sentiment of the score, such as `POSITIVE`. | ||
| data.filmography[].critics_score.title | string | No | Tomatometer | Name of the score, such as `Tomatometer` or `Popcornmeter`. | ||
| data.filmography[].path | string | No | /m/oppenheimer_2023 | Rotten Tomatoes path of the title page, such as `/m/oppenheimer_2023`. | ||
| data.filmography[].position | integer | No | 1 | Position of the credit in the filmography list, starting at 1. | ||
| data.filmography[].poster_url | string | No | URL of the title's poster image. | |||
| data.filmography[].title | string | No | Oppenheimer | Name of the title, as Rotten Tomatoes shows it. | ||
| data.filmography[].url | string | No | https://www.rottentomatoes.com/m/oppenheimer_2023 | Rotten Tomatoes page URL of the title. | ||
| data.filmography[].years_featured | string | No | 2023 | Year or years shown for the title in the filmography. | ||
| data.filmography_api_url | string | No | https://www.rottentomatoes.com/cnapi/modules/filmography/a015d515-713e-38e3-abbe-cf0cdaa519b0/movie/newest | URL of the Rotten Tomatoes filmography list for this person. | ||
| data.highest_rated | object | No | Highest-rated title of the person, with its score. | |||
| data.highest_rated.path | string | No | /m/the_dark_knight | Rotten Tomatoes path of the title page, such as `/m/the_dark_knight`. | ||
| data.highest_rated.score | integer | No | 94 | Critics score of the title, as a percentage. | ||
| data.highest_rated.title | string | No | The Dark Knight | Name of the title, as Rotten Tomatoes shows it. | ||
| data.highest_rated.url | string | No | https://www.rottentomatoes.com/m/the_dark_knight | Rotten Tomatoes page URL of the title. | ||
| data.highest_rated.year | string | No | 2008 | Release year of the title. | ||
| data.image_url | string | No | URL of the person's photo. | |||
| data.lowest_rated | object | No | Lowest-rated title of the person, with its score. | |||
| data.lowest_rated.path | string | No | /m/the_dark_knight | Rotten Tomatoes path of the title page, such as `/m/the_dark_knight`. | ||
| data.lowest_rated.score | integer | No | 94 | Critics score of the title, as a percentage. | ||
| data.lowest_rated.title | string | No | The Dark Knight | Name of the title, as Rotten Tomatoes shows it. | ||
| data.lowest_rated.url | string | No | https://www.rottentomatoes.com/m/the_dark_knight | Rotten Tomatoes page URL of the title. | ||
| data.lowest_rated.year | string | No | 2008 | Release year of the title. | ||
| data.name | string | No | Christopher Nolan | Name of the person. | ||
| data.page_info | object | No | Paging information for the filmography. | |||
| data.page_info.end_cursor | string | No | Mjk= | Cursor of the last item on this page. Pass it as `after` to get the next page. | ||
| data.page_info.has_next_page | boolean | No | true | Whether more items follow this page. | ||
| data.page_info.has_previous_page | boolean | No | true | Whether items precede this page. | ||
| data.page_info.start_cursor | string | No | MA== | Cursor of the first item on this page. | ||
| data.path | string | No | /celebrity/christopher_nolan | Rotten Tomatoes path of the person page, such as `/celebrity/christopher_nolan`. | ||
| data.public_page_derived | boolean | No | true | Always `true`: the data comes from publicly visible Rotten Tomatoes pages. | ||
| data.source_url | string | No | https://www.rottentomatoes.com/celebrity/christopher_nolan | URL the data was read from. | ||
| data.url | string | No | https://www.rottentomatoes.com/celebrity/christopher_nolan | Rotten Tomatoes page URL of the person. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/rottentomatoes/person" \
-H "x-api-key: $CRAWLORA_API_KEY"