v1

latestOpenAPI 3.1.12026-07-1711423400.3 KB

seasons

Retrieve season episodes.

This endpoint will retrieve the episodes in a certain season.

get/seasons/{seasonID}/episodes

Path parameters

seasonIDinteger required

ID of the season.

Query parameters

hide_fillers0 | 1

Indicates whether filler episodes should be included.

0 = Include fillers
1 = No fillers

limitstring

The limit on the number of objects, or number of objects in the specified relationship, that are returned. The default value is 25 and the maximum value is 100.

pagestring

The next page or group of objects to fetch. The default value is 1.

Response

Successful GET Seasons Episodes JSON response

object required

Example response

{
  "data": [
    {
      "id": 1,
      "type": "episodes",
      "href": "/v1/episodes/1",
      "attributes": {
        "poster": {
          "url": "https://kurozora-cdn.app/episodes/1_poster.png",
          "height": 200,
          "width": 140,
          "backgroundColor": "#d2c6bd",
          "textColor1": "#30475d",
          "textColor2": "#8f2c1d",
          "textColor3": "#a46c39",
          "textColor4": "#ac7867"
        },
        "banner": {
          "url": "https://kurozora-cdn.app/episodes/1_banner.png",
          "height": 480,
          "width": 640,
          "backgroundColor": "#c4dbdf",
          "textColor1": "#3e779f",
          "textColor2": "#6bb2cc",
          "textColor3": "#5d5b5e",
          "textColor4": "#727466"
        },
        "number": 1,
        "numberTotal": 1,
        "title": "Episode 1",
        "synopsis": "A short, or long description of the episode.",
        "duration": "24 minutes",
        "startedAt": 959731200,
        "isFiller": false,
        "isVerified": false,
        "isWatched": true
      }
    },
    {
      "id": 2,
      "type": "episodes",
      "href": "/v1/seasons/2/episodes",
      "attributes": {
        "poster": {
          "url": "https://kurozora-cdn.app/episodes/2_poster.png",
          "height": 200,
          "width": 140,
          "backgroundColor": "#d2c6bd",
          "textColor1": "#30475d",
          "textColor2": "#8f2c1d",
          "textColor3": "#a46c39",
          "textColor4": "#ac7867"
        },
        "banner": {
          "url": "https://kurozora-cdn.app/episodes/2_banner.png",
          "height": 480,
          "width": 640,
          "backgroundColor": "#c4dbdf",
          "textColor1": "#3e779f",
          "textColor2": "#6bb2cc",
          "textColor3": "#5d5b5e",
          "textColor4": "#727466"
        },
        "number": 2,
        "numberTotal": 2,
        "title": "Episode 2",
        "synopsis": "A long, or short description of the episode.",
        "duration": "24 minutes",
        "startedAt": 959731200,
        "isFiller": true,
        "isVerified": false,
        "isWatched": false
      }
    }
  ]
}