API REFERENCE

Get Artist

On this page

GET/api/spotify/artist/

Get Spotify catalog information for a single artist identified by their unique Spotify ID.

Authentication

See the authentication guide for API key and account access requirements.

Request

cURL

curl --request GET \
  --url 'https://api.recoupable.dev/api/spotify/artist/?id=YOUR_ID' \
  --header 'x-api-key: YOUR_API_KEY'

Replace the YOUR_ placeholders with your values. Required query parameters are included; optional parameters are listed below.

Parameters

Query parameters

idstringrequired

The Spotify ID of the artist

Responses

200Artist retrieved successfully

application/json

artistobjectnullable

The Spotify artist object (null if error)

Properties

external_urlsobject

Properties

spotifystring

The Spotify URL for the object

followersobject

Properties

hrefstringnullable

This will always be set to null

totalinteger

The total number of followers

genresarray<string>

A list of the genres the artist is associated with

Item properties

string

hrefstring

A link to the Web API endpoint providing full details

idstring

The Spotify ID for the artist

imagesarray<SpotifyImage>

Images of the artist in various sizes

Item properties

urlstring

The source URL of the image

heightintegernullable

The image height in pixels

widthintegernullable

The image width in pixels

namestring

The name of the artist

popularityinteger

The popularity of the artist (0-100)

typestring · enum

The object type, always 'artist'

Values: "artist"

uristring

The Spotify URI for the artist

errorobjectnullable

Error object if request failed (null if successful)

400Bad request - missing required parameters

application/json

errorobject

Error details

Properties

statusinteger

HTTP status code

messagestring

Error message

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download social.json

View operation source

json

{
  "description": "Get Spotify catalog information for a single artist identified by their unique Spotify ID.",
  "parameters": [
    {
      "name": "id",
      "in": "query",
      "description": "The Spotify ID of the artist",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Artist retrieved successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SpotifyGetArtistResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request - missing required parameters",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/SpotifyErrorResponse"
          }
        }
      }
    }
  }
}