How do I make a Next-Gen API call?

How do I make a Next-Gen API call?

The Next-Gen API uses get request instead of post request. This host a whole new set of parameter's and data that we can grab quickly in a new method.

To build a URL you will always use the base URL of https://api.luminatedata.com/ 


To add onto this URL you will pick the endpoint, for this example we will use the Musical_recordings endpoint, musical_recordings/{id}

Example, https://api.luminatedata.com/musical_recordings/{id} 


From this URL,https://api.luminatedata.com/musical_recordings/{id}, we will now add the first parameter to the URL with the format of:
?{parameter}={value}

Adding in a ID type would be as follows, ?id_type=isrc (this would be used if you are passing in a ISRC to the Musical Recording endpoint)

Example, https://api.luminatedata.com/musical_recordings/{id}?id_type=isrc

To add any more parameters onto this URL use this format, &{parameter}={value}. 

Adding a second parameter, like relationships at the none level, would be adding &relationships=none

Example, https://api.luminatedata.com/musical_recordings/{id}?id_type=isrc&relationships=none

The final parameter we will add is metrics, &metrics=all

Example, https://api.luminatedata.com/musical_recordings/{id}?id_type=isrc&relationships=none&metrics=all

This will give us 1 week of data on an ISRC in the Musical Recordings endpoint

You can add as many optional parameters you would like! 
To see a list of endpoints and the available parameters, click here



    • Related Articles

    • Luminate Next-Gen Connect API Welcome Letter

      Your Luminate Next-Gen Connect API access is live! Here are some materials to help you get started! API Documentation in SwaggerHub FAQ on Data Definitions: What do the different acronyms mean? FAQ on Authorization: How do I use the interactive ...

    • What is the Next Gen API?

      The Next-Gen API is our newest product to go to Beta. This API enables programmatic access to streaming, sales, and airplay data accross the world! This includes: Over 200 available charts, including all Billboard charts Weekly consumption data for ...

    • Where can I find the Next-Gen API Documentation?

      Fully interactive documentation of the Music Connect API is available here. It allows you to explore how the API will work and behave, before integrating it into your code.

    • How do I use the interactive Next-Gen API documentation?

      If you have an active "Luminate Data" account with access to the Music Connect API, you can explore the API here. In order to use the different endpoints, you need to authorize: Click on the first section for the POST /auth endpoint on the left side ...

    • Introducing the Luminate Next Gen Music Platform

      We are excited to announce the Luminate Next Gen Music Platform for music consumption data is now available! The new user-friendly Beta platform, which processes trillions of data sources, allows you to uncover invaluable trends and behaviors in ...

    • Popular Articles

    • Welcome to the all new Luminate Music Platform, Connect!

      Luminate is the preeminent entertainment data and insights company, unleashing access to the most essential, objective, and trustworthy information across music, film and television, with data compiled from hundreds of verified sources. Today, the ...

    • Luminate Next Gen Connect Overview

      For a quick overview of Luminate's Next Gen Connect please check out the video below! As the platform evolves this video will update to reflect the current status and features. So please bookmark and check back!

    • How do I get my music tracked by Luminate Data?

      Luminate Data tracks sales, streaming, and in North America, radio airplay. You must register your ISRC, UPC/EAN, and encode your music to be fully tracked. The registration process will take 2-3 business days. We can check if your registration was ...

    • Analysis Intro

      See below for a quick overview of the Analysis module in Luminate Music: Click here for more details on the Analysis module in Luminate Music.

    • Activity By Location (Country) Intro

      See below for a quick overview of the Activity by Location module for an Artist, Song, or Release Group in Luminate Music: Click here for more details on Activity By Location module in Luminate Music.