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 schemaKey | 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 episodesYou 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 episodeYou 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 responseYou 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 responseYou 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 sortYou 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" }]