📱 DSPs

Digital Service Providers for music streaming and distribution platforms

Resource Overview

DSPs (Digital Service Providers) represent streaming platforms and digital music stores where albums can be distributed. This includes major platforms like Spotify, Apple Music, Amazon Music, YouTube Music, and many others. DSPs are read-only reference data that define available distribution targets for music content.

Base Endpoint
/dsps
Resource Type
dsps
Access Level
Read-only reference data

Schema

Read-only Attributes

Field Type Description
id string Unique identifier
name string Display name of the DSP (e.g., "Spotify", "Apple Music", "Amazon Music")

List DSPs

GET /dsps Read Only 
GET /dsps
Authorization: Bearer {token}
Accept: application/vnd.api+json

Query Parameters

Filtering

  • • filter[name] - Filter by DSP display name
  • • filter[id] - Filter by specific DSP IDs

Other Parameters

  • • sort - Sort by name
  • • page[number] - Page number
  • • page[size] - Results per page

Example Request

GET /dsps?sort=name&page[size]=20

Success Response

200 OK 
{
  "data": [
    {
      "type": "dsps",
      "id": "1",
      "attributes": {
        "name": "Spotify"
      }
    },
    {
      "type": "dsps",
      "id": "2",
      "attributes": {
        "name": "Apple Music"
      }
    },
    {
      "type": "dsps",
      "id": "3",
      "attributes": {
        "name": "Amazon Music"
      }
    }
  ],
  "meta": {
    "page": {
      "current-page": 1,
      "per-page": 20,
      "total": 45,
      "last-page": 3
    }
  }
}

Get Single DSP

GET /dsps/{id} 
GET /dsps/1
Authorization: Bearer {token}
Accept: application/vnd.api+json

Success Response

200 OK 
{
  "data": {
    "type": "dsps",
    "id": "1",
    "attributes": {
      "name": "Spotify"
    }
  }
}

Usage Examples

🎵 List Available DSPs

Get all available streaming platforms for distribution

# Get all DSPs
GET /dsps

# Search DSPs by name
GET /dsps?filter[name]=Spotify

🔍 Find Specific DSPs

Filter and search for specific streaming platforms

# Get specific DSPs by ID
GET /dsps?filter[id]=1,2,5

# Sort DSPs alphabetically
GET /dsps?sort=name

# Get single DSP details
GET /dsps/1

📊 Integration Examples

Common integration patterns for DSP data

# For distribution request creation
GET /dsps?page[size]=100

# For analytics and reporting
GET /dsps?sort=name

# For user DSP selection interfaces
GET /dsps?filter[name]=Music