Docs menu

TMDB API endpoint

TMDB Movie API

Returns a TMDB movie: overview, tagline, genres, countries, runtime, budget/revenue, top-billed cast, top crew (director/writer), and aggregate rating.

GETapiKey3 credits/requestTMDBtmdb.movieResponseDoc/tmdb/movie/{id}

Endpoint facts

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

TMDB Scraper API Try TMDB Movie API in Playground TMDB API documentation

How this endpoint behaves

Path parameters:

id (required) — TMDB movie id.

Response includes top_crew[] (the director/writer summary shown on the movie page — not the full production crew), cast[] (capped at 25 credits), genres[], countries[], status, original_language, budget, revenue, homepage, rating (average, count, review_count), uri, source_url.

Live monitoring

Monitored request: GET /tmdb/movie/27205
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.28 s

Current status of every endpoint

Sampled response

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

Field	Filled in, of 9 checked	Values in the sample
name	9	“Leonardo DiCaprio” and 8 other values
slug	9
character	9	“Dom Cobb” and 8 other values

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "27205",
    "title": "Inception",
    "tagline": "Your mind is the scene of the crime.",
    "overview": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets is offered a chance to regain his old life as payment for a task considered to be impossible: \"inception\", the implantation of another person's idea into a target's subconscious.",
    "release_date": "2010-07-15",
    "year": 2010,
    "runtime_minutes": 148,
    "genres": [
      "Action",
      "Science Fiction",
      "Adventure"
    ],
    "countries": [
      "United States",
      "United Kingdom"
    ],
    "status": "Released",
    "original_language": "English",
    "budget": 160000000,
    "revenue": 839030630,
    "homepage": "https://www.warnerbros.com/movies/inception",
    "poster_url": "https://image.tmdb.org/t/p/w500/xlaY2zyzMfkhk0HSC5VUwzoZPU1.jpg",
    "rating": {
      "average": 8.372,
      "count": 39524,
      "review_count": 8
    },
    "top_crew": [
      {
        "name": "Christopher Nolan",
        "slug": "525",
        "jobs": [
          "Director",
          "Writer"
        ]
      }
    ],
    "cast": [
      {
        "name": "Leonardo DiCaprio",
        "slug": "6193",
        "character": "Dom Cobb"
      }
    ],
    "uri": "https://www.themoviedb.org/movie/27205-inception",
    "source_url": "https://www.themoviedb.org/movie/27205"
  }
}

Request schema

No body schema

Response schema

#/definitions/tmdb.movieResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	tmdb.MovieResponse	No
data.budget	number	No
data.cast	array	No
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
data.genres	array	No
data.homepage	string	No
data.id	string	No	27205
data.original_language	string	No	English
data.overview	string	No
data.poster_url	string	No
data.rating	tmdb.Rating	No
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.release_date	string	No	2010-07-15
data.revenue	number	No
data.runtime_minutes	integer	No	148
data.source_url	string	No
data.status	string	No	Released
data.tagline	string	No
data.title	string	No	Inception
data.top_crew	array	No
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
data.year	integer	No	2010
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/movie/27205" \
  -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 List API documentation TMDB Person API documentation TMDB Popular People API documentation TMDB Search API documentation

Open in Playground Back to group

Docs menu

TMDB API endpoint

TMDB Movie API

Returns a TMDB movie: overview, tagline, genres, countries, runtime, budget/revenue, top-billed cast, top crew (director/writer), and aggregate rating.

GETapiKey3 credits/requestTMDBtmdb.movieResponseDoc/tmdb/movie/{id}

Endpoint facts

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

TMDB Scraper API Try TMDB Movie API in Playground TMDB API documentation

How this endpoint behaves

Path parameters:

id (required) — TMDB movie id.

Live monitoring

Monitored request: GET /tmdb/movie/27205
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.28 s

Current status of every endpoint

Sampled response

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

Field	Filled in, of 9 checked	Values in the sample
name	9	“Leonardo DiCaprio” and 8 other values
slug	9
character	9	“Dom Cobb” and 8 other values

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "27205",
    "title": "Inception",
    "tagline": "Your mind is the scene of the crime.",
    "overview": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets is offered a chance to regain his old life as payment for a task considered to be impossible: \"inception\", the implantation of another person's idea into a target's subconscious.",
    "release_date": "2010-07-15",
    "year": 2010,
    "runtime_minutes": 148,
    "genres": [
      "Action",
      "Science Fiction",
      "Adventure"
    ],
    "countries": [
      "United States",
      "United Kingdom"
    ],
    "status": "Released",
    "original_language": "English",
    "budget": 160000000,
    "revenue": 839030630,
    "homepage": "https://www.warnerbros.com/movies/inception",
    "poster_url": "https://image.tmdb.org/t/p/w500/xlaY2zyzMfkhk0HSC5VUwzoZPU1.jpg",
    "rating": {
      "average": 8.372,
      "count": 39524,
      "review_count": 8
    },
    "top_crew": [
      {
        "name": "Christopher Nolan",
        "slug": "525",
        "jobs": [
          "Director",
          "Writer"
        ]
      }
    ],
    "cast": [
      {
        "name": "Leonardo DiCaprio",
        "slug": "6193",
        "character": "Dom Cobb"
      }
    ],
    "uri": "https://www.themoviedb.org/movie/27205-inception",
    "source_url": "https://www.themoviedb.org/movie/27205"
  }
}

Request schema

No body schema

Response schema

#/definitions/tmdb.movieResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	tmdb.MovieResponse	No
data.budget	number	No
data.cast	array	No
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
data.genres	array	No
data.homepage	string	No
data.id	string	No	27205
data.original_language	string	No	English
data.overview	string	No
data.poster_url	string	No
data.rating	tmdb.Rating	No
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.release_date	string	No	2010-07-15
data.revenue	number	No
data.runtime_minutes	integer	No	148
data.source_url	string	No
data.status	string	No	Released
data.tagline	string	No
data.title	string	No	Inception
data.top_crew	array	No
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
data.year	integer	No	2010
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/movie/27205" \
  -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 Movie 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 Movie 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