Episode

Currently there are 23 episodes spanning over two seasons released in 2018 and 2019.

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 is currently in development and it's data will be added after it's release.

Episode schema

KeyTypeDescription
idintThe id of the episode (starting from 1).
namestringThe name of the episode.
air_datestringThe air date of the episode.
directorstringThe director of the episode.
writerstringThe writer of the episode.
charactersarrayDifferent characters of the episode.
img_urlstring (url)Link to the episode's image.

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"
}
]
Last updated on by Ashutosh