Apple Artists

AppleArtist resource allows listing and creating artist representations specific to Apple Music platform. The AppleArtist resource links your artists to Apple Music's catalog, providing Apple-specific metadata like genre classification and locale information.

List Apple artists

GET

https://api.idol.io/api/v2

/apple-artists

Retrieve a list of Apple Music artist representations

List Apple artists › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

filter[name]

string

Filter by artist name

filter[distributor-id]

string

Filter by distributor ID

List Apple artists › Responses

Successful response

AppleArtistListResponse

AppleArtistResource[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

PaginationMeta

PaginationLinks

Create an Apple artist

POST

https://api.idol.io/api/v2

/apple-artists

Create a new Apple Music artist representation.

Required fields: distributor-id, name

Create an Apple artist › Request Body

AppleArtistCreateRequest

AppleArtistResource · required

Create an Apple artist › Responses

Apple artist created successfully

AppleArtistResponse

AppleArtistResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

POST/apple-artists

curl https://api.idol.io/api/v2/apple-artists \
  --request POST \
  --header 'Content-Type: application/vnd.api+json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "data": {
    "type": "apple-artists",
    "attributes": {
      "distributor-id": 123,
      "name": "La Femme"
    }
  }
}'

Example Request Body

{
  "data": {
    "type": "apple-artists",
    "attributes": {
      "distributor-id": 123,
      "name": "La Femme"
    }
  }
}

json

application/vnd.api+json

Example Responses

{
  "data": {
    "type": "apple-artists",
    "id": "id",
    "attributes": {
      "name": "name",
      "apple-id": "apple-id",
      "genre": "genre",
      "locale": "locale",
      "apple-url": "https://www.example.com/path/to/resource"
    }
  },
  "included": [
    {}
  ],
  "links": {
    "self": "https://www.example.com/path/to/resource"
  }
}

json

application/vnd.api+json

Get Apple artist details

GET

https://api.idol.io/api/v2

/apple-artists/{id}

Retrieve a single Apple artist by ID

Get Apple artist details › path Parameters

id

string · required

Resource ID

Get Apple artist details › query Parameters

include

string

Comma-separated list of related resources to include

Get Apple artist details › Responses

Successful response

AppleArtistResponse

AppleArtistResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

Retails Spotify Artists

Labelcamp API v2

Apple Artists

List Apple artists

GET

https://api.idol.io/api/v2

/apple-artists

Retrieve a list of Apple Music artist representations

List Apple artists › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

filter[name]

string

Filter by artist name

filter[distributor-id]

string

Filter by distributor ID

List Apple artists › Responses

Successful response

AppleArtistListResponse

AppleArtistResource[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

PaginationMeta

PaginationLinks

Create an Apple artist

POST

https://api.idol.io/api/v2

/apple-artists

Create a new Apple Music artist representation.

Required fields: distributor-id, name

Create an Apple artist › Request Body

AppleArtistCreateRequest

AppleArtistResource · required

Create an Apple artist › Responses

Apple artist created successfully

AppleArtistResponse

AppleArtistResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

POST/apple-artists

curl https://api.idol.io/api/v2/apple-artists \
  --request POST \
  --header 'Content-Type: application/vnd.api+json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "data": {
    "type": "apple-artists",
    "attributes": {
      "distributor-id": 123,
      "name": "La Femme"
    }
  }
}'

Example Request Body

{
  "data": {
    "type": "apple-artists",
    "attributes": {
      "distributor-id": 123,
      "name": "La Femme"
    }
  }
}

json

application/vnd.api+json

Example Responses

{
  "data": {
    "type": "apple-artists",
    "id": "id",
    "attributes": {
      "name": "name",
      "apple-id": "apple-id",
      "genre": "genre",
      "locale": "locale",
      "apple-url": "https://www.example.com/path/to/resource"
    }
  },
  "included": [
    {}
  ],
  "links": {
    "self": "https://www.example.com/path/to/resource"
  }
}

json

application/vnd.api+json

Get Apple artist details

GET

https://api.idol.io/api/v2

/apple-artists/{id}

Retrieve a single Apple artist by ID

Get Apple artist details › path Parameters

id

string · required

Resource ID

Get Apple artist details › query Parameters

include

string

Comma-separated list of related resources to include

Get Apple artist details › Responses

Successful response

AppleArtistResponse

AppleArtistResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

Retails Spotify Artists