---
title: "Rotten Tomatoes series detail"
method: GET
path: "/rottentomatoes/series"
tags: ["Rotten Tomatoes"]
---

# Rotten Tomatoes series detail

`GET /rottentomatoes/series`

## Request

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

Returns Rotten Tomatoes TV series metadata and scorecard data. Pass exactly one of `path` or `url`.

## Query parameters

- `path` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesSeriesResponseDoc
  - `code` integer
  - `data` RottentomatoesSeriesResponse
    - `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`.
    - `cast` RottentomatoesPerson[]: People in the cast of the series.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `content_rating` string: Content rating of the series, such as `TV-14`.
    - `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`.
    - `description` string: Short synopsis of the series.
    - `directors` RottentomatoesPerson[]: Directors of the series.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `ems_id` string: Rotten Tomatoes' own unique id of the series.
    - `end_date` string: Date the series ended, such as `2013-09-29`.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `genres` string[]: Genres of the series.
    - `image_url` string: URL of the series image.
    - `lifecycle` string: Airing status of the series, such as `NOT_AIRING`.
    - `media_type` string: Kind of title, such as `TvSeries`.
    - `number_of_seasons` integer: Number of seasons of the series.
    - `path` string: Rotten Tomatoes path of the series page, such as `/tv/breaking_bad`.
    - `producers` RottentomatoesPerson[]: Producers of the series.
      - `image_url` string: URL of the person's photo.
      - `name` string: Name of the person.
      - `url` string: Rotten Tomatoes page URL of the person.
    - `public_page_derived` boolean: Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
    - `seasons` RottentomatoesTVSeason[]: Seasons of the series, each with a link to its page.
      - `name` string: Season name, such as `Season 1`.
      - `path` string: Rotten Tomatoes path of the season page, such as `/tv/breaking_bad/s01`.
      - `url` string: Rotten Tomatoes page URL of the season.
    - `source_url` string: URL the data was read from.
    - `start_date` string: Date the series first aired, such as `2008-01-20`.
    - `title` string: Title of the series, as Rotten Tomatoes shows it.
    - `url` string: Rotten Tomatoes page URL of the series.
  - `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)