---
title: "Rotten Tomatoes TV discovery rows"
method: GET
path: "/rottentomatoes/browse/tv"
tags: ["Rotten Tomatoes"]
---

# Rotten Tomatoes TV discovery rows

`GET /rottentomatoes/browse/tv`

## Request

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

Returns TV series rows from Rotten Tomatoes' browse listing. Use `/rottentomatoes/browse/filters?list=tv_series_browse` to discover current filters; pagination uses the opaque `after` cursor from the previous response.

## Query parameters

- `list` 'tv_series_browse'
- `sort` 'popular' | 'newest' | 'a_z' | 'critic_highest' | 'critic_lowest' | 'audience_highest' | 'audience_lowest'
- `genres` 'action' | 'adventure' | 'animation' | 'anime' | 'biography' | 'comedy' | 'crime' | 'documentary' | 'drama' | 'entertainment' | 'faith_and_spirituality' | 'fantasy' | 'game_show' | 'lgbtq' | 'health_and_wellness' | 'history' | 'holiday' | 'horror' | 'house_and_garden' | 'kids_and_family' | 'music' | 'musical' | 'mystery_and_thriller' | 'nature' | 'news' | 'reality' | 'romance' | 'sci_fi' | 'short' | 'soap' | 'special_interest' | 'sports' | 'stand_up' | 'talk_show' | 'travel' | 'variety' | 'war' | 'western'
- `ratings` 'tvy' | 'tvy7' | 'tvg' | 'tvpg' | 'tv14' | 'tvma'
- `audience` 'upright' | 'spilled'
- `critics` 'fresh' | 'rotten'
- `affiliates` 'theaters' | 'fandango' | 'apple-tv-plus' | 'netflix' | 'prime-video' | 'disney-plus' | 'max' | 'peacock' | 'hulu' | 'paramount-plus' | 'amc-plus' | 'acorn-tv' | 'apple-tv'
- `after` string
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- RottentomatoesBrowseResponseDoc
  - `code` integer
  - `data` RottentomatoesBrowseResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `items` RottentomatoesBrowseItem[]: Titles on this page of the browse list.
      - `critics_review_count` integer: Number of critic reviews behind the Tomatometer score.
      - `date_created` string: Release date text shown on the browse card, such as `2026`.
      - `image_url` string: URL of the poster image.
      - `media_type` string: Kind of title, such as `Movie`.
      - `path` string: Rotten Tomatoes path of the title page, such as `/m/wildwood_nj`.
      - `position` integer: Position of the title in the returned list, starting at 1.
      - `title` string: Title name as shown on the browse card.
      - `tomatometer_score` integer: Tomatometer critics score, as a percentage.
      - `url` string: Rotten Tomatoes page URL of the title.
      - `video` RottentomatoesEpisodeVideo
        - `description` string: Description of the video.
        - `duration` string: Length of the video as text, such as `2:32`.
        - `thumbnail` string: URL of the video thumbnail image.
        - `title` string: Title of the video.
        - `upload_date` string: Date and time the video was uploaded, such as `2024-07-11T19:23:03`.
        - `url` string: Rotten Tomatoes page URL of the video.
    - `limit` integer: Maximum number of rows requested.
    - `list` string: Browse list that was returned, such as `movies_in_theaters`.
    - `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.
    - `public_page_derived` boolean: Always `true`: the data comes from publicly visible Rotten Tomatoes pages.
    - `sort` string: Sort order applied to the list, such as `popular`.
    - `source_url` string: URL the data was read from.
    - `title` string: Title of the browse list, as Rotten Tomatoes shows it.
  - `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/028417aa35bb?raw)