---
title: "Get a TMDB TV show"
method: GET
path: "/tmdb/tv/{id}"
tags: ["TMDB"]
---

# Get a TMDB TV show

`GET /tmdb/tv/{id}`

## Request

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

Returns a TMDB TV show: overview, tagline, genres, countries, episode count, first/last air year, top-billed cast, top crew (creator), and aggregate rating.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TmdbTvResponseDoc
  - `code` integer
  - `data` TmdbTVResponse
    - `cast` TmdbCastCredit[]: Top-billed cast, up to 25 credits.
      - `character` string: Character the actor plays.
      - `name` string: Name of the actor.
      - `slug` string: TMDB person id of the actor.
    - `countries` string[]: Countries the show comes from.
    - `first_air_year` integer: Year the show first aired.
    - `genres` string[]: Genres of the show.
    - `homepage` string: URL of the show's official website.
    - `id` string: TMDB id of the TV show.
    - `last_air_year` integer: Year the show last aired. Omitted for shows still airing.
    - `number_of_episodes` integer: Total number of episodes.
    - `original_language` string: Original language of the show, for example `English`.
    - `overview` string: Plot summary of the show.
    - `poster_url` string: URL of the poster image.
    - `rating` TmdbRating
      - `average` number: Average TMDB user rating, on a 0 to 10 scale.
      - `count` integer: Number of user ratings behind the average.
      - `review_count` integer: Number of written user reviews. Omitted when TMDB shows none.
    - `source_url` string: URL the data was read from.
    - `status` string: Production status of the show, for example `Ended`.
    - `tagline` string: Tagline of the show.
    - `title` string: Title of the show.
    - `top_crew` TmdbCrewCredit[]: Top-billed crew, such as the creator.
      - `jobs` string[]: Jobs the person holds on the title, for example `Creator` or `Director`.
      - `name` string: Name of the crew member.
      - `slug` string: TMDB person id of the crew member.
    - `uri` string: Link to the show's page on TMDB.
  - `msg` string

## Other responses

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