JustWatch API endpoint
Lists the JustWatch genres, each with its `short_name` (such as `act`) and a translated name in the `language` you choose (two-letter code, default `en`). Use the short names as the `genre` input of the genre titles endpoint. An invalid language returns `400`.
/justwatch/genreslanguage optional string. Two-letter language code. Defaults to en.language values return 400.503.| Field | Filled in, of 19 checked | Values in the sample |
|---|---|---|
| short_name | 19 | “crm” and 18 other values |
| translation | 19 | “Crime” and 18 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| 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/genres?language=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"language": "en",
"genres": [
{
"short_name": "act",
"translation": "Action & Adventure"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/justwatch.genresResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | justwatch.GenresResponse | No | ||||
| data.genres | array | No | Genres available on JustWatch. | |||
| data.genres[].short_name | string | No | act | Short genre code accepted as a filter, for example `act`. | ||
| data.genres[].translation | string | No | Action & Adventure | Genre name in the requested language, for example `Action & Adventure`. | ||
| data.language | string | No | en | Two-letter language code the genre names are translated into. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/genres?language=en" \
-H "x-api-key: $CRAWLORA_API_KEY"