Docs menu

TMDB API endpoint

TMDB TV Show API

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

GETapiKey3 credits/requestTMDBtmdb.tvResponseDoc/tmdb/tv/{id}

Endpoint facts

Method: GET
API path: /tmdb/tv/{id}
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: TMDB
Response schema: #/definitions/tmdb.tvResponseDoc

TMDB Scraper API Try TMDB TV Show API in Playground TMDB API documentation

How this endpoint behaves

Path parameters:

id (required) — TMDB TV show id.

Response includes first_air_year/last_air_year (only the year range is available, not a first-air date; last_air_year is omitted for shows still airing), number_of_episodes, top_crew[] (e.g. the creator), cast[] (capped at 25 credits), genres[], countries[], status, original_language, rating, uri, source_url.

Live monitoring

Monitored request: GET /tmdb/tv/1396
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.07 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tmdb/tv/1396
Items in cast: 9
Fields filled in every checked item: 3

Field	Filled in, of 9 checked	Values in the sample
name	9	“Bryan Cranston” and 8 other values
slug	9
character	9	“Walter White” and 8 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
id (path)	string	Yes		TMDB TV show id	1396
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tmdb/tv/1396" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "1396",
    "title": "Breaking Bad",
    "tagline": "Change the equation.",
    "overview": "Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime.",
    "first_air_year": 2008,
    "last_air_year": 2013,
    "number_of_episodes": 62,
    "genres": [
      "Drama",
      "Crime"
    ],
    "countries": [
      "United States"
    ],
    "status": "Ended",
    "original_language": "English",
    "homepage": "https://www.sonypictures.com/tv/breakingbad",
    "poster_url": "https://image.tmdb.org/t/p/w500/ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg",
    "rating": {
      "average": 8.9,
      "count": 18088,
      "review_count": 5
    },
    "top_crew": [
      {
        "name": "Vince Gilligan",
        "slug": "66633",
        "jobs": [
          "Creator"
        ]
      }
    ],
    "cast": [
      {
        "name": "Bryan Cranston",
        "slug": "17419",
        "character": "Walter White"
      }
    ],
    "uri": "https://www.themoviedb.org/tv/1396-breaking-bad",
    "source_url": "https://www.themoviedb.org/tv/1396"
  }
}

Request schema

No body schema

Response schema

#/definitions/tmdb.tvResponseDoc

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

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tmdb/tv/1396" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More TMDB endpoint docs TMDB Scraper API TMDB Collection API documentation TMDB Browse Genres API documentation TMDB Movie API documentation TMDB Movie List API documentation TMDB Person API documentation TMDB Popular People API documentation

Open in Playground Back to group

Docs menu

TMDB API endpoint

TMDB TV Show API

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

GETapiKey3 credits/requestTMDBtmdb.tvResponseDoc/tmdb/tv/{id}

Endpoint facts

Method: GET
API path: /tmdb/tv/{id}
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: TMDB
Response schema: #/definitions/tmdb.tvResponseDoc

TMDB Scraper API Try TMDB TV Show API in Playground TMDB API documentation

How this endpoint behaves

Path parameters:

id (required) — TMDB TV show id.

Live monitoring

Monitored request: GET /tmdb/tv/1396
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.07 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /tmdb/tv/1396
Items in cast: 9
Fields filled in every checked item: 3

Field	Filled in, of 9 checked	Values in the sample
name	9	“Bryan Cranston” and 8 other values
slug	9
character	9	“Walter White” and 8 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
id (path)	string	Yes		TMDB TV show id	1396
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tmdb/tv/1396" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "1396",
    "title": "Breaking Bad",
    "tagline": "Change the equation.",
    "overview": "Walter White, a New Mexico chemistry teacher, is diagnosed with Stage III cancer and given a prognosis of only two years left to live. He becomes filled with a sense of fearlessness and an unrelenting desire to secure his family's financial future at any cost as he enters the dangerous world of drugs and crime.",
    "first_air_year": 2008,
    "last_air_year": 2013,
    "number_of_episodes": 62,
    "genres": [
      "Drama",
      "Crime"
    ],
    "countries": [
      "United States"
    ],
    "status": "Ended",
    "original_language": "English",
    "homepage": "https://www.sonypictures.com/tv/breakingbad",
    "poster_url": "https://image.tmdb.org/t/p/w500/ztkUQFLlC19CCMYHW9o1zWhJRNq.jpg",
    "rating": {
      "average": 8.9,
      "count": 18088,
      "review_count": 5
    },
    "top_crew": [
      {
        "name": "Vince Gilligan",
        "slug": "66633",
        "jobs": [
          "Creator"
        ]
      }
    ],
    "cast": [
      {
        "name": "Bryan Cranston",
        "slug": "17419",
        "character": "Walter White"
      }
    ],
    "uri": "https://www.themoviedb.org/tv/1396-breaking-bad",
    "source_url": "https://www.themoviedb.org/tv/1396"
  }
}

Request schema

No body schema

Response schema

#/definitions/tmdb.tvResponseDoc

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

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tmdb/tv/1396" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

TMDB TV Show API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

TMDB TV Show API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related