Welcome to the Luminate API developer documentation!

📊 Get Access to Data

The Luminate 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 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 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.