---
title: "Get JustWatch title media"
method: GET
path: "/justwatch/title/media"
tags: ["JustWatch"]
---

# Get JustWatch title media

`GET /justwatch/title/media`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/justwatch/title/media`
- Auth: API key in header `x-api-key`

Returns the media for a JustWatch movie or show `id` (`tm` or `ts` followed by digits): credits with role, name, character and person id, video clips with provider and URL, and backdrop image URLs. `country` defaults to `US` and `language` to `en`. YouTube clips carry a watch URL. An unknown id returns `404`.

## Query parameters

- `id` string, required
- `country` string
- `language` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchTitleMediaResponseDoc
  - `code` integer
  - `data` JustwatchTitleMediaResponse
    - `backdrops` JustwatchBackdrop[]: Backdrop images for the title.
      - `url` string: URL of a backdrop image for the title.
    - `clips` JustwatchClip[]: Trailers and other video clips for the title.
      - `external_id` string: Video id of the clip on the hosting site.
      - `provider` string: Site hosting the clip, for example `YOUTUBE`.
      - `url` string: URL where the clip can be watched.
    - `country` string: Two-letter ISO country code the results are for.
    - `credits` JustwatchCredit[]: Cast and crew credited on the title.
      - `character_name` string: Character the person plays. Omitted for crew roles.
      - `name` string: Full name of the person.
      - `person_id` integer: JustWatch id of the person.
      - `role` string: Role of the person on the title, for example `ACTOR`.
    - `id` string: JustWatch title id the media belongs to, for example `tm92641`.
    - `language` string: Two-letter language code used for titles and descriptions.
    - `title` string: Name of the title in the requested language.
  - `msg` string

## Other responses

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