Episode
Currently there are 36 episodes spanning over three seasons released in 2018, 2019 and 2021.
Season 1 premiered on TBS and consists of 10 episodes which are named as Chapter 1, Chapter 2, Chapter 3, etc.
Season 2 premiered in 2019 on Adult Swim and consists of 13 episodes.
Season 3 premiered on March 20, 2021 and consists of 13 episodes.
Episode schema#
| Key | Type | Description |
|---|---|---|
| id | int | The id of the episode (starting from 1). |
| name | string | The name of the episode. |
| air_date | string | The air date of the episode. |
| director | string | The director of the episode. |
| writer | string | The writer of the episode. |
| characters | array | Different characters of the episode. |
| img_url | string (url) | Link to the episode's image. (640x480) |
Get all episodes#
You can access the list of episodes by using the /episode endpoint.
https://finalspaceapi.com/api/v0/episode/[ { "id": 1, "name": "Chapter 1", "air_date": "02/15/2018", "director": "Mike Roberts", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/2", "https://finalspaceapi.com/api/v0/character/3", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/11" ], "img_url": "http://finalspaceapi.com/episode/image/chapter1.jpg" }, ...]Get a single episode#
You can get a single episode by adding the id as a parameter: /episode/15
https://finalspaceapi.com/api/v0/episode/15{ "id": 15, "name": "The Notorious Mrs. Goodspeed", "air_date": "06/22/2019", "director": "Yoriaki Mochizuki", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/7", "https://finalspaceapi.com/api/v0/character/8", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/10", "https://finalspaceapi.com/api/v0/character/11", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/13", "https://finalspaceapi.com/api/v0/character/16" ], "img_url": "http://finalspaceapi.com/episode/image/the_notorious_mrs_goodspeed.jpg"}Sort the response#
You can now sort the response based on id by passing the /?sort=asc or /?sort=desc query in the URL.
https://finalspaceapi.com/api/v0/episode/?sort=desc[ { "id": 23, "name": "The Sixth Key", "air_date": "08/23/2019", "director": "Yoriaki Mochizuki", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/7", "https://finalspaceapi.com/api/v0/character/8", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/13", "https://finalspaceapi.com/api/v0/character/16" ], "img_url": "http://finalspaceapi.com/episode/image/the_sixth_key.jpg" }, ...]Limit the response#
You can now limit the response by passing the /?limit={number} query in the URL.
https://finalspaceapi.com/api/v0/episode/?limit=3[ { "id": 1, "name": "Chapter 1", "air_date": "02/15/2018", "director": "Mike Roberts", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/2", "https://finalspaceapi.com/api/v0/character/3", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/11" ], "img_url": "http://finalspaceapi.com/api/episode/image/chapter1.jpg" }, { "id": 2, "name": "Chapter 2", "air_date": "02/15/2018", "director": "Mike Roberts", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/2", "https://finalspaceapi.com/api/v0/character/3", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/10", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/14" ], "img_url": "http://finalspaceapi.com/api/episode/image/chapter2.jpg" }, { "id": 3, "name": "Chapter 3", "air_date": "02/26/2018", "director": "Mike Roberts", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/3", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/11", "https://finalspaceapi.com/api/v0/character/14" ], "img_url": "http://finalspaceapi.com/api/episode/image/chapter3.jpg" }]Use limit with sort#
You can limit and sort the response simultaneously by passing both limit={number} and sort=desc query parameters in the URL and seperating them with & operator.
https://finalspaceapi.com/api/v0/episode/?limit=3&sort=desc[ { "id": 23, "name": "The Sixth Key", "air_date": "08/23/2019", "director": "Yoriaki Mochizuki", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/5", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/7", "https://finalspaceapi.com/api/v0/character/8", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/13", "https://finalspaceapi.com/api/v0/character/16" ], "img_url": "http://finalspaceapi.com/api/episode/image/the_sixth_key.jpg" }, { "id": 22, "name": "The Descent Into Darkness", "air_date": "08/16/2019", "director": "Yoriaki Mochizuki", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/7", "https://finalspaceapi.com/api/v0/character/8", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/13", "https://finalspaceapi.com/api/v0/character/16", "https://finalspaceapi.com/api/v0/character/17" ], "img_url": "http://finalspaceapi.com/api/episode/image/the_descent_into_darkness.jpg" }, { "id": 21, "name": "The Set Up", "air_date": "08/09/2019", "director": "Anne Walker Farrell", "writer": "Olan Rogers", "characters": [ "https://finalspaceapi.com/api/v0/character/1", "https://finalspaceapi.com/api/v0/character/4", "https://finalspaceapi.com/api/v0/character/6", "https://finalspaceapi.com/api/v0/character/7", "https://finalspaceapi.com/api/v0/character/8", "https://finalspaceapi.com/api/v0/character/9", "https://finalspaceapi.com/api/v0/character/10", "https://finalspaceapi.com/api/v0/character/12", "https://finalspaceapi.com/api/v0/character/13", "https://finalspaceapi.com/api/v0/character/16" ], "img_url": "http://finalspaceapi.com/api/episode/image/the_set_up.jpg" }]