---
title: "Get JustWatch season by raw id"
method: GET
path: "/justwatch/season/by-id"
tags: ["JustWatch"]
---

# Get JustWatch season by raw id

`GET /justwatch/season/by-id`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/justwatch/season/by-id`
- Auth: API key in header `x-api-key`

Looks up one JustWatch season by its raw `id` (`tss` followed by digits, such as `tss297253`), in the `country` (default `US`) and `language` (default `en`) you choose. Returns the season title, number, year, description, path, URL and poster. A valid id with no match returns `404`.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchSeasonByIDResponseDoc
  - `code` integer
  - `data` JustwatchSeasonByIDResponse
    - `country` string: Two-letter ISO country code the results are for.
    - `language` string: Two-letter language code used for titles and descriptions.
    - `season` JustwatchSeasonSummary
      - `description` string: Short synopsis of the season.
      - `id` string: JustWatch season id, for example `tss297253`.
      - `object_id` integer: Numeric JustWatch id of the season.
      - `object_type` string: JustWatch object type, `SHOW_SEASON` for seasons.
      - `path` string: JustWatch page path of the season.
      - `poster_url` string: URL of the poster image for the season.
      - `season_number` integer: Number of the season within the show.
      - `title` string: Season title, for example `Season 1`.
      - `url` string: Full JustWatch page URL of the season.
      - `year` integer: Release year of the season.
  - `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/028417aa35bb?raw)