---
title: "Get a TMDB TV chart"
method: GET
path: "/tmdb/tv/list"
tags: ["TMDB"]
---

# Get a TMDB TV chart

`GET /tmdb/tv/list`

## Request

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

Returns a page of TMDB TV shows from the `category` chart (`popular` by default, or `top_rated`, `airing_today`, `on_the_air`), optionally refined by `sort_by`, `with_genres`, `original_language`, first-air-date bounds `date_from` and `date_to`, rating, votes and runtime. `limit` defaults to 10 (max 20). A filtered page with no matches returns an empty `shows` array.

## Query parameters

- `category` 'popular' | 'top_rated' | 'airing_today' | 'on_the_air'
- `page` integer
- `sort_by` 'popularity.desc' | 'popularity.asc' | 'vote_average.desc' | 'vote_average.asc' | 'first_air_date.desc' | 'first_air_date.asc' | 'name.asc' | 'name.desc'
- `with_genres` string
- `original_language` string
- `date_from` string
- `date_to` string
- `min_rating` number
- `max_rating` number
- `min_votes` integer
- `min_runtime` integer
- `max_runtime` integer
- `include_adult` boolean
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TmdbTvListResponseDoc
  - `code` integer
  - `data` TmdbTVListResponse
    - `category` string: TV chart that was returned: `popular`, `top_rated`, `airing_today` or `on_the_air`.
    - `has_next_page` boolean: True when more pages of shows are available.
    - `page` integer: Page number returned.
    - `shows` TmdbMediaRef[]: TV shows on this page, one item per show.
      - `id` string: TMDB id of the movie or TV show. Use it with the movie or TV detail endpoint.
      - `overview` string: Short plot summary. Not filled in for list and chart results.
      - `poster_url` string: URL of the poster image. Not filled in for list and chart results.
      - `release_date` string: Release or first air date. Not filled in for list and chart results.
      - `title` string: Title of the movie or TV show.
      - `uri` string: Link to the title's page on TMDB.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `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)