Welcome to the Luminate Music API developer documentation!

🔐 Authenticate

The first step to accessing the Luminate Music API is to go through the authentication process. Please review the Authentication documentation for an outline of the steps and requirements.

📊 Get Access to Data

The Luminate Music API provides access to data from 50 different territories via 5 endpoints:

/musical_recordings (ISRC)
/song
/musical_products (Barcode)
/musical_release_groups (Album)
/artists

Retrieve the following types of data from the aforementioned endpoints:

Metadata
Relationships
Discography
External IDs
Consumption Data

The Luminate Music API includes intelligent categorization of consumption data via "breakouts", allowing users to understand the various methods in which the market consumed the specified ID.

{
  "metrics": [
    {
      "name": "Streams",
      "value": [
        {
          "name": "total",
          "value": 19892402
        },
        {
          "name": "commercial_model",
          "value": [
            {
              "name": "ad_supported",
              "value": 3204397
            },
            {
              "name": "premium",
              "value": 16688005
            }
          ]
        },
        {
          "name": "content_type",
          "value": [
            {
              "name": "audio",
              "value": 19194807
            },
            {
              "name": "video",
              "value": 697595
            }
          ]
        },
        {
          "name": "service_type",
          "value": [
            {
              "name": "on_demand",
              "value": 18733631
            },
            {
              "name": "programmed",
              "value": 1158771
            }
          ]
        }
      ]
    }
  ]
}

🔍 Use Filters to Derive Insights

Our new Data Filters enable the user to analyze the data with precise granularity. All of the breakouts that are returned in the API can be used as query parameters. For example, by appending content_type=audio, you will filter all of the streaming activity by audio-based streams. Multiple filters can be applied to a single request for deeper analysis: content_type=audio&service_type=on_demand.

See the Data Filters documentation for further information on this topic.

{
  "metrics": [
    {
      "name": "Streams",
      "value": [
        {
          "name": "total",
          "value": 18036036
        },
        {
          "name": "commercial_model",
          "value": [
            {
              "name": "ad_supported",
              "value": 1419881
            },
            {
              "name": "premium",
              "value": 16616155
            }
          ]
        },
        {
          "name": "content_type",
          "value": [
            {
              "name": "audio",
              "value": 18036036
            },
            {
              "name": "video",
              "value": 0
            }
          ]
        },
        {
          "name": "service_type",
          "value": [
            {
              "name": "on_demand",
              "value": 18036036
            },
            {
              "name": "programmed",
              "value": 0
            }
          ]
        }
      ]
    }
  ]
}

🎛 Improve Your Queries with Developer-Friendly Error Messaging

Encountered a 4xx or 5xx error when querying the Luminate Music API? No fear! Our developer-friendly error messages will quickly identify the root cause and guide you to a successful request.

{
    "error": {
        "errors": [
            {
                "error_code": "00017",
                "error_type": "Incompatible Values",
                "message": "start_date must be less than or equal to end_date."
            }
        ],
        "code": 400,
        "message": "Bad Request"
    }
}

📬 We're here to help!

Please reach out to [email protected] if you have any questions.