Luminate API Updates
March 2025
New dimensions have been added to the product sales dataset.
Two new breakouts and filters have been added: product_format and release_type.
The product_format data has been added to the following endpoints:
/musical_products/musical_release_groups/artists
The release_type data is only available in the /artists endpoint.
February 2025
ATD (activity-to-date) has been added to the Luminate API.
This feature allows customers to see the complete history of the specified entity. To include this data in the response, the user will need to the append the atd parameter to the request and input the value for which metrics they want to see. The parameter and all possible values are documented in the API Reference.
The ATD values can be filtered by the streaming and product sales filters, but not by the market filters. See our Data Filters documentation to see how this functionality works.
{
"metrics": [
{
"name": "Streams",
"value": [
{
"name": "total",
"value": 182116349
},
{
"name": "atd",
"value": 70994157979
}
]
},
{
"name": "Sales",
"value": [
{
"name": "Song Sales",
"value": [
{
"name": "total",
"value": 7913
},
{
"name": "atd",
"value": 40446264
}
]
},
{
"name": "Product Sales",
"value": [
{
"name": "total",
"value": 22567
},
{
"name": "atd",
"value": 31392713
}
]
}
]
}
]
}September 2024
Market-Level data is now available in the Luminate API!
Users can now see or filter by market activity in all 5 API endpoints. One, several, or all markets can be requested via the markets query parameter. Also, daily or weekly data can be filtered via the market_filter query parameter. A list of all supported Market IDs can be found in the "Luminate IDs" folder in the Guides tab.
Note: This data is limited to the US and Canada.
{
"metrics": [
{
"name": "Streams",
"value": [
{
"name": "total",
"value": [
{
"market_name": "New York, NY",
"market_id": "1",
"value": [
{
"name": "total",
"value": 2332049
}
]
},
{
"market_name": "Los Angeles, CA",
"market_id": "2",
"value": [
{
"name": "total",
"value": 1686187
}
]
},
{
"market_name": "Chicago, IL",
"market_id": "3",
"value": [
{
"name": "total",
"value": 899979
}
]
},
{
"market_name": "Philadelphia, PA",
"market_id": "4",
"value": [
{
"name": "total",
"value": 783412
}
]
},
{
"market_name": "San Francisco et al, CA",
"market_id": "5",
"value": [
{
"name": "total",
"value": 738777
}
]
}
]
}
]
},
{
"name": "Sales",
"value": [
{
"name": "Song Sales",
"value": [
{
"name": "total",
"value": [
{
"market_name": "New York, NY",
"market_id": "1",
"value": [
{
"name": "total",
"value": 262
}
]
},
{
"market_name": "Los Angeles, CA",
"market_id": "2",
"value": [
{
"name": "total",
"value": 205
}
]
},
{
"market_name": "Chicago, IL",
"market_id": "3",
"value": [
{
"name": "total",
"value": 108
}
]
},
{
"market_name": "Philadelphia, PA",
"market_id": "4",
"value": [
{
"name": "total",
"value": 134
}
]
},
{
"market_name": "San Francisco et al, CA",
"market_id": "5",
"value": [
{
"name": "total",
"value": 146
}
]
}
]
}
]
},
{
"name": "Product Sales",
"value": [
{
"name": "total",
"value": [
{
"market_name": "New York, NY",
"market_id": "1",
"value": [
{
"name": "total",
"value": 89
}
]
},
{
"market_name": "Los Angeles, CA",
"market_id": "2",
"value": [
{
"name": "total",
"value": 93
}
]
},
{
"market_name": "Chicago, IL",
"market_id": "3",
"value": [
{
"name": "total",
"value": 44
}
]
},
{
"market_name": "Philadelphia, PA",
"market_id": "4",
"value": [
{
"name": "total",
"value": 44
}
]
},
{
"market_name": "San Francisco et al, CA",
"market_id": "5",
"value": [
{
"name": "total",
"value": 53
}
]
}
]
}
]
}
]
}
]
}August 2024
Enhancements to product sales were introduced to the following endpoints:
/musical_products/musical_release_groups/artists
Product sales are now classified according to these 3 breakouts: distribution_channel, purchase_method, store_strata. As seen with the streaming filters, these breakouts can also be used a query parameters to filter the product sales data. For example, by appending purchase_method=online to your request, you will filter all of the product sales data by music that was purchased via the internet (see data sample below).
{
"metrics": [
{
"name": "Sales",
"value": [
{
"name": "Product Sales",
"value": [
{
"name": "total",
"value": 950
},
{
"name": "distribution_channel",
"value": [
{
"name": "physical",
"value": 100
},
{
"name": "digital",
"value": 850
}
]
},
{
"name": "store_strata",
"value": [
{
"name": "e-commerce",
"value": 50
},
{
"name": "mass_market",
"value": 100
},
{
"name": "independent",
"value": 50
},
{
"name": "direct_to_consumer",
"value": 300
},
{
"name": "venue",
"value": 150
},
{
"name": "non-traditional",
"value": 300
}
]
},
{
"name": "purchase_method",
"value": [
{
"name": "online",
"value": 950
},
{
"name": "store_front",
"value": 0
}
]
},
{
"name": "release_type",
"value": [
{
"name": "album",
"value": 450
},
{
"name": "single",
"value": 300
},
{
"name": "ep",
"value": 50
},
{
"name": "video",
"value": 150
}
]
},
{
"name": "product_format",
"value": [
{
"name": "cd",
"value": 200
},
{
"name": "casssette",
"value": 25
},
{
"name": "vinyl",
"value": 50
},
{
"name": "mxcd",
"value": 50
},
{
"name": "digital",
"value": 400
},
{
"name": "dvd",
"value": 75
},
{
"name": "vhs",
"value": 0
},
{
"name": "laser",
"value": 50
},
{
"name": "unknown",
"value": 100
}
]
}
]
}
]
}
]
}Product sales are now classified according to these 3 breakouts: distribution_channel, purchase_method, store_strata. As seen with the streaming filters, these breakouts can also be used a query parameters to filter the product sales data. For example, by appending purchase_method=online to your request, you will filter all of the product sales data by music that was purchased via the internet (see data sample below).
{
"metrics": [
{
"name": "Sales",
"value": [
{
"name": "Product Sales",
"value": [
{
"name": "total",
"value": 950
},
{
"name": "distribution_channel",
"value": [
{
"name": "physical",
"value": 100
},
{
"name": "digital",
"value": 850
}
]
},
{
"name": "store_strata",
"value": [
{
"name": "e-commerce",
"value": 50
},
{
"name": "mass_market",
"value": 100
},
{
"name": "independent",
"value": 50
},
{
"name": "direct_to_consumer",
"value": 300
},
{
"name": "venue",
"value": 150
},
{
"name": "non-traditional",
"value": 300
}
]
},
{
"name": "purchase_method",
"value": [
{
"name": "online",
"value": 950
},
{
"name": "store_front",
"value": 0
}
]
},
{
"name": "release_type",
"value": [
{
"name": "album",
"value": 450
},
{
"name": "single",
"value": 300
},
{
"name": "ep",
"value": 50
},
{
"name": "video",
"value": 150
}
]
},
{
"name": "product_format",
"value": [
{
"name": "cd",
"value": 200
},
{
"name": "casssette",
"value": 25
},
{
"name": "vinyl",
"value": 50
},
{
"name": "mxcd",
"value": 50
},
{
"name": "digital",
"value": 400
},
{
"name": "dvd",
"value": 75
},
{
"name": "vhs",
"value": 0
},
{
"name": "laser",
"value": 50
},
{
"name": "unknown",
"value": 100
}
]
}
]
}
]
}
]
}