Skip to main content

Artists API

The Artists API allows you to manage and retrieve artist information.

List Artists​

Get a list of artists.

Endpoint: GET /artists

Headers:

  • X-F-Authorization: Client token (required)

Response:

[
  {
    "id": "artist-id",
    "name": "Artist Name",
    "photo": "https://example.com/photo.jpg",
    "bio": "Artist biography",
    "spotify": "https://open.spotify.com/artist/...",
    "soundcloud": "https://soundcloud.com/...",
    "youtube": "https://youtube.com/...",
    "genres": [
      {
        "id": "genre-id",
        "name": "Electronic"
      }
    ]
  }
]

Get Artist​

Get details of a specific artist.

Endpoint: GET /artists/:id

Headers:

  • X-F-Authorization: Client token (required)

Response:

{
  "id": "artist-id",
  "name": "Artist Name",
  "photo": "https://example.com/photo.jpg",
  "bio": "Artist biography",
  "spotify": "https://open.spotify.com/artist/...",
  "soundcloud": "https://soundcloud.com/...",
  "youtube": "https://youtube.com/...",
  "genres": [
    {
      "id": "genre-id",
      "name": "Electronic"
    }
  ]
}

Create Artist(s)​

Create one or more artists.

Endpoint: POST /artists

Headers:

  • X-F-Authorization: Client token (required)
  • X-F-Authentication: User token (required)

Request Body (Single Artist):

{
  "name": "Artist Name",
  "photo": "base64-encoded-image-or-url",
  "bio": "Artist biography",
  "spotify": "https://open.spotify.com/artist/...",
  "soundcloud": "https://soundcloud.com/...",
  "youtube": "https://youtube.com/...",
  "genres": ["Electronic", "House"]
}

Request Body (Multiple Artists):

{
  "artists": [
    {
      "name": "Artist 1",
      "genres": ["Electronic"]
    },
    {
      "name": "Artist 2",
      "genres": ["House"]
    }
  ]
}

Response: Returns the created artist(s) object(s).

Update Artist​

Update an existing artist.

Endpoint: PUT /artists/:id

Headers:

  • X-F-Authorization: Client token (required)
  • X-F-Authentication: User token (required)

Request Body: Same as create, but all fields are optional.

Delete Artist​

Delete an artist.

Endpoint: DELETE /artists/:id

Headers:

  • X-F-Authorization: Client token (required)
  • X-F-Authentication: User token (required)