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
}
]
}
]
}
]
}
]
}