---
title: "Rotten Tomatoes person detail and filmography"
method: GET
path: "/rottentomatoes/person"
tags: ["Rotten Tomatoes"]
---

# Rotten Tomatoes person detail and filmography

`GET /rottentomatoes/person`

## Request

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

Returns Rotten Tomatoes celebrity/person metadata and filmography rows. Pass exactly one of `path` or `url`.

## Query parameters

- `path` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesPersonResponseDoc
  - `code` integer
  - `data` RottentomatoesPersonResponse
    - `birth_date` string: Date of birth, such as `1970-07-30`.
    - `birthplace` string: Place of birth, such as `London, England, UK`.
    - `description` string: Biography text of the person.
    - `ems_id` string: Rotten Tomatoes' own unique id of the person.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `filmography` RottentomatoesPersonCredit[]: Titles the person has credits on, one entry per title.
      - `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`.
      - `credits` string: Roles the person had on the title, such as `Director, Screenwriter, Producer`.
      - `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`.
      - `path` string: Rotten Tomatoes path of the title page, such as `/m/oppenheimer_2023`.
      - `position` integer: Position of the credit in the filmography list, starting at 1.
      - `poster_url` string: URL of the title's poster image.
      - `title` string: Name of the title, as Rotten Tomatoes shows it.
      - `url` string: Rotten Tomatoes page URL of the title.
      - `years_featured` string: Year or years shown for the title in the filmography.
    - `filmography_api_url` string: URL of the Rotten Tomatoes filmography list for this person.
    - `highest_rated` RottentomatoesPersonRatedTitle
      - `path` string: Rotten Tomatoes path of the title page, such as `/m/the_dark_knight`.
      - `score` integer: Critics score of the title, as a percentage.
      - `title` string: Name of the title, as Rotten Tomatoes shows it.
      - `url` string: Rotten Tomatoes page URL of the title.
      - `year` string: Release year of the title.
    - `image_url` string: URL of the person's photo.
    - `lowest_rated` RottentomatoesPersonRatedTitle
      - `path` string: Rotten Tomatoes path of the title page, such as `/m/the_dark_knight`.
      - `score` integer: Critics score of the title, as a percentage.
      - `title` string: Name of the title, as Rotten Tomatoes shows it.
      - `url` string: Rotten Tomatoes page URL of the title.
      - `year` string: Release year of the title.
    - `name` string: Name of the person.
    - `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.
    - `path` string: Rotten Tomatoes path of the person page, such as `/celebrity/christopher_nolan`.
    - `public_page_derived` boolean: Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
    - `source_url` string: URL the data was read from.
    - `url` string: Rotten Tomatoes page URL of the person.
  - `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)