Skip to main content

​
Overview

The Artist resource represents music artists, performers, and groups. Artists can be individual performers or groups, and can have member relationships with other artists.

​
List Artists

​
GET
endpoint
/api/artist
Retrieve a paginated list of artists.

​
Query Parameters

​
page[size]
integer
Number of results per page (default: 15, max: 100)
​
page[number]
integer
Page number to retrieve
​
include
string
Comma-separated list of relationships to include. Available includes:
  • songs - Associated songs (deprecated, use performances)
  • performances - Song performances
  • performances.song - Songs from performances
  • memberships - Member relationships
  • memberships.performances - Performances through memberships
  • members - Individual members (for groups)
  • groups - Groups this artist belongs to
  • images - Artist images
  • resources - External resources (social media, websites)
  • songs.animethemes - Anime themes for songs
  • songs.animethemes.anime - Anime for themes
​
filter[name]
string
Filter by artist name
​
fields[artist]
string
Comma-separated list of fields to return. Available fields:
  • artist_id
  • name
  • slug
  • information
​
sort
string
Sort by field. Prefix with - for descending order. Available: name, created_at, updated_at
​
q
string
Full-text search query across artist names and performances

​
Response

​
artists
array
Array of artist objects
​
artist_id
integer
Unique identifier
​
name
string
Artist name
​
slug
string
URL-friendly identifier
​
information
string
Additional information about the artist
​
created_at
string
ISO 8601 timestamp
​
updated_at
string
ISO 8601 timestamp

​
Example Request

curl "https://api.animethemes.moe/api/artist?include=performances.song,images&page[size]=10"

​
Example Response

{
  "artists": [
    {
      "artist_id": 1,
      "name": "The Seatbelts",
      "slug": "the_seatbelts",
      "information": "Jazz band led by composer Yoko Kanno",
      "created_at": "2024-01-15T12:00:00.000000Z",
      "updated_at": "2024-01-15T12:00:00.000000Z",
      "performances": [
        {
          "performance_id": 1,
          "song_id": 1,
          "as": "Artist",
          "song": {
            "song_id": 1,
            "title": "Tank!",
            "title_native": null
          }
        }
      ],
      "images": [
        {
          "image_id": 1,
          "facet": "Cover",
          "link": "https://animethemes.moe/storage/images/the_seatbelts.jpg"
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.animethemes.moe/api/artist?page[number]=1",
    "next": "https://api.animethemes.moe/api/artist?page[number]=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 10
  }
}

​
Show Artist

​
GET
endpoint
/api/artist/:slug
Retrieve a single artist by their slug.

​
Path Parameters

​
slug
string
required
The artist slug (URL-friendly identifier)

​
Query Parameters

​
include
string
Same includes as list endpoint

​
Example Request

curl "https://api.animethemes.moe/api/artist/the_seatbelts?include=performances.song.animethemes.anime,members"

​
Example Response

{
  "artist": {
    "artist_id": 1,
    "name": "The Seatbelts",
    "slug": "the_seatbelts",
    "information": "Jazz band led by composer Yoko Kanno",
    "created_at": "2024-01-15T12:00:00.000000Z",
    "updated_at": "2024-01-15T12:00:00.000000Z",
    "performances": [
      {
        "performance_id": 1,
        "song_id": 1,
        "as": "Artist",
        "song": {
          "song_id": 1,
          "title": "Tank!",
          "animethemes": [
            {
              "theme_id": 1,
              "type": "OP",
              "sequence": 1,
              "anime": {
                "anime_id": 1,
                "name": "Cowboy Bebop"
              }
            }
          ]
        }
      }
    ],
    "members": [
      {
        "artist_id": 2,
        "name": "Yoko Kanno",
        "slug": "yoko_kanno"
      }
    ]
  }
}

​
Create Artist

​
POST
endpoint
/api/artist
Create a new artist. Requires authentication.

​
Request Body

​
name
string
required
Artist name
​
slug
string
required
URL-friendly identifier (unique)
​
information
string
Additional information about the artist

​
Update Artist

​
PUT
endpoint
/api/artist/:slug
Update an existing artist. Requires authentication.

​
Request Body

Same fields as create endpoint (all optional).

​
Delete Artist

​
DELETE
endpoint
/api/artist/:slug
Soft delete an artist. Requires authentication.

​
Restore Artist

​
PATCH
endpoint
/restore/artist/:slug
Restore a soft-deleted artist. Requires authentication.

​
Force Delete Artist

​
DELETE
endpoint
/forceDelete/artist/:slug
Permanently delete an artist. Requires authentication.

Build docs developers (and LLMs) love

Get started for freeTalk to us