DSPs

Digital Service Providers (Spotify, Apple Music, etc.)

List DSPs (Digital Service Providers)

GET

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

/dsps

Retrieve a list of digital service providers with optional filtering by distributor.

List DSPs (Digital Service Providers) › query Parameters

filter[distributor-id]

string

Filter by distributor ID

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

List DSPs (Digital Service Providers) › Responses

List of DSPs

DspResource[]

PaginationMeta

GET/dsps

curl https://api.idol.io/api/v2/dsps \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "type": "dsps",
      "id": "1",
      "attributes": {
        "name": "Apple",
        "image-url": "https://example.com/logos/apple.png"
      }
    },
    {
      "type": "dsps",
      "id": "2",
      "attributes": {
        "name": "Deezer",
        "image-url": "https://example.com/logos/deezer.png"
      }
    },
    {
      "type": "dsps",
      "id": "3",
      "attributes": {
        "name": "TikTok",
        "image-url": "https://example.com/logos/tiktok.png"
      }
    },
    {
      "type": "dsps",
      "id": "4",
      "attributes": {
        "name": "Amazon",
        "image-url": "https://example.com/logos/amazon.png"
      }
    },
    {
      "type": "dsps",
      "id": "5",
      "attributes": {
        "name": "YouTube Content ID",
        "image-url": "https://example.com/logos/youtube.png"
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pages": 1,
      "count": 5
    }
  }
}

json

application/vnd.api+json

Get a specific DSP

GET

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

/dsps/{id}

Retrieve a single digital service provider by its ID.

Get a specific DSP › path Parameters

id

string · required

The DSP ID

Get a specific DSP › Responses

A single DSP

DspResource

Availabilities DSP Upload Identifications

Labelcamp API v2

DSPs

Digital Service Providers (Spotify, Apple Music, etc.)

List DSPs (Digital Service Providers)

GET

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

/dsps

Retrieve a list of digital service providers with optional filtering by distributor.

List DSPs (Digital Service Providers) › query Parameters

filter[distributor-id]

string

Filter by distributor ID

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

List DSPs (Digital Service Providers) › Responses

List of DSPs

DspResource[]

PaginationMeta

GET/dsps

curl https://api.idol.io/api/v2/dsps \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "type": "dsps",
      "id": "1",
      "attributes": {
        "name": "Apple",
        "image-url": "https://example.com/logos/apple.png"
      }
    },
    {
      "type": "dsps",
      "id": "2",
      "attributes": {
        "name": "Deezer",
        "image-url": "https://example.com/logos/deezer.png"
      }
    },
    {
      "type": "dsps",
      "id": "3",
      "attributes": {
        "name": "TikTok",
        "image-url": "https://example.com/logos/tiktok.png"
      }
    },
    {
      "type": "dsps",
      "id": "4",
      "attributes": {
        "name": "Amazon",
        "image-url": "https://example.com/logos/amazon.png"
      }
    },
    {
      "type": "dsps",
      "id": "5",
      "attributes": {
        "name": "YouTube Content ID",
        "image-url": "https://example.com/logos/youtube.png"
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pages": 1,
      "count": 5
    }
  }
}

json

application/vnd.api+json

Get a specific DSP

GET

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

/dsps/{id}

Retrieve a single digital service provider by its ID.

Get a specific DSP › path Parameters

id

string · required

The DSP ID

Get a specific DSP › Responses

A single DSP

DspResource

Availabilities DSP Upload Identifications