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

# Get a TMDB movie

`GET /tmdb/movie/{id}`

## Request

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

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

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TmdbMovieResponseDoc
  - `code` integer
  - `data` TmdbMovieResponse
    - `budget` number
    - `cast` TmdbCastCredit[]
      - `character` string: Character the actor plays.
      - `name` string: Name of the actor.
      - `slug` string: TMDB person id of the actor.
    - `countries` string[]
    - `genres` string[]
    - `homepage` string
    - `id` string
    - `original_language` string
    - `overview` string
    - `poster_url` string
    - `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.
    - `release_date` string
    - `revenue` number
    - `runtime_minutes` integer
    - `source_url` string
    - `status` string
    - `tagline` string
    - `title` string
    - `top_crew` TmdbCrewCredit[]
      - `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
    - `year` integer
  - `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/0497899e2016?raw)