Skip to main content

Song

This is an object representing an Anime show's opening or ending song. The API allows you to retrieve individual Song as well as a list of them using various filters.

Endpoints
GET/v1/song/:id
GET/v1/song
GET/v1/random/song/:count

The Song object#

Attributes#


id integer#

Unique identifier for a Song.


anime_id integer#

Anime external unique identifier.


title string#

The song's original title.


artist string#

The song's artist name.


album string#

The song's album name.


year integer#

The song's release year.


season enum#

The song's release season.

Possible season enum values
"WINTER": 0,"SPRING": 1,"SUMMER": 2,"FALL": 3,"UNKNOWN": 4

duration integer#

The song's duration in milliseconds.


preview_url string#

The song's Spotify preview url, which provides ~30 seconds of the song.


open_spotify_url string#

The song's Spotify Web Player url to listen to it.


local_spotify_url string#

The song's Spotify App url to listen to it. This url will open your local Spotify application automatically.


type enum#

The song's type.

Possible type enum values
"OPENING": 0,"ENDING": 1,"NONE": 2

Example#

Song object example
{  "anime_id": 1,  "title": "The Real Folk Blues",  "artist": "Mai Yamane",  "album": "COWBOY BEBOP Vitaminless",  "year": 1998,  "season": 1,  "duration": 377066,  "preview_url": "https://p.scdn.co/mp3-preview/a2226076e4b89e16d8827189fd32da4535d369b4?cid=b074c52808fb4394a28785f381872ea2",  "open_spotify_url": "https://open.spotify.com/track/5Cmf3LmbLd9g79rS55X7qK",  "local_spotify_url": "spotify:track:5Cmf3LmbLd9g79rS55X7qK",  "type": 1,  "id": 1}

Retrieve a specific Song#

GET/v1/song/:id

Retrieves an Anime show's Song, based on its unique identifier.

Parameters#

No parameters.

Returns#

Returns a Song object if a valid identifier was provided.

Try it#

This feature is not available on mobile.

Get a list of Song#

GET/v1/song

Returns a list of Song objects. The Songs are returned sorted by year descending, after by season descending.

Parameters#


anime_id integer optional#

A filter on the list based on the anime_id field value.


title string optional#

A case-insensitive pattern filter on the list based on the title field value.


artist string optional#

A case-insensitive pattern filter on the list based on the artist field value.


year integer optional#

A filter on the list based on the year field value.


season enum optional#

A filter on the list based on the season field value.


type enum optional#

A filter on the list based on the type field value.


Returns#

Returns an array of Anime objects with a size based on the filter provided.

Try it#

This feature is not available on mobile.

Retrieve random Songs#

GET/v1/random/song/:count

Retrieves a random Anime show's Song list.

Parameters#

No parameters.

Returns#

Returns a random Song list.

Try it#

This feature is not available on mobile.