JustWatch API endpoint
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`.
/justwatch/title/mediaReturns credits, clips, and backdrops for a raw JustWatch movie or show id.
id required string. Raw JustWatch title id matching tm[0-9]+ or ts[0-9]+, for example tm92641.country optional string. Two-letter country code. Defaults to US.language optional string. Two-letter language code. Defaults to en.id, country, or language values return 400.node: null returns 404.503.| Field | Filled in, of 53 checked | Values in the sample |
|---|---|---|
| role | 53 | ACTOR (52), DIRECTOR (1) |
| name | 53 | “Leonardo DiCaprio” and 52 other values |
| character_name | 52 | “Dom Cobb” and 35 other values |
| person_id | 53 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Raw JustWatch movie/show id matching tm[0-9]+ or ts[0-9]+ | tm92641 | |
| country | string | No | Two-letter country code | US | |
| language | string | No | Two-letter language code | en | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/justwatch/title/media?id=tm92641&country=us&language=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "tm92641",
"country": "US",
"language": "en",
"title": "Inception",
"credits": [
{
"role": "ACTOR",
"name": "Leonardo DiCaprio",
"character_name": "Dom Cobb",
"person_id": 1641
}
],
"clips": [
{
"provider": "YOUTUBE",
"external_id": "8hP9D6kZseM",
"url": "https://www.youtube.com/watch?v=8hP9D6kZseM"
}
],
"backdrops": [
{
"url": "https://images.justwatch.com/backdrop/8735151/s1920/inception.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/justwatch.titleMediaResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | justwatch.TitleMediaResponse | No | ||||
| data.backdrops | array | No | Backdrop images for the title. | |||
| data.backdrops[].url | string | No | https://images.justwatch.com/backdrop/8735151/s1920/inception.jpg | URL of a backdrop image for the title. | ||
| data.clips | array | No | Trailers and other video clips for the title. | |||
| data.clips[].external_id | string | No | 8hP9D6kZseM | Video id of the clip on the hosting site. | ||
| data.clips[].provider | string | No | YOUTUBE | Site hosting the clip, for example `YOUTUBE`. | ||
| data.clips[].url | string | No | https://www.youtube.com/watch?v=8hP9D6kZseM | URL where the clip can be watched. | ||
| data.country | string | No | US | Two-letter ISO country code the results are for. | ||
| data.credits | array | No | Cast and crew credited on the title. | |||
| data.credits[].character_name | string | No | Dom Cobb | Character the person plays. Omitted for crew roles. | ||
| data.credits[].name | string | No | Leonardo DiCaprio | Full name of the person. | ||
| data.credits[].person_id | integer | No | 1641 | JustWatch id of the person. | ||
| data.credits[].role | string | No | ACTOR | Role of the person on the title, for example `ACTOR`. | ||
| data.id | string | No | tm92641 | JustWatch title id the media belongs to, for example `tm92641`. | ||
| data.language | string | No | en | Two-letter language code used for titles and descriptions. | ||
| data.title | string | No | Inception | Name of the title in the requested language. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/justwatch/title/media?id=tm92641&country=us&language=en" \
-H "x-api-key: $CRAWLORA_API_KEY"