Songs

get

https://api.luminatedata.com/songs/{id}

Receive metadata and consumption data for a Song using a Luminate ID or ISRC.

Path Params

string

required

Unique Luminate ID or ISRC assigned to the Song.

Query Params

id_type

string

enum

Use the id_type parameter to specify the source of the ID. If the id_type is not specified, the endpoint will expect a Luminate ID.

Allowed:

location

string

Geographic territory used in the aggregation of the consumption data. Value must be formatted according to the ISO 3166-1 alpha-2 standard. Full list of supported locations can be found in the "Luminate IDs" folder in the Guides tab.

start_date

string

First date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD). If the start_date is not specified, the default value is 7 days prior to the current date or 7 days prior to the end_date.

end_date

string

Last date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD). If the end_date is not specified, the default value is the current date or 7 days after the start_date.

chart_week

string

Represents the 7-day period (Fri-Thur) used in the aggregation of consumption data. Value must be formatted according to the ISO 8601 week standard (YYYY-Www).

metadata_level

string

enum

Specify the volume of metadata returned in the response.

Allowed:

external_ids

string

enum

Retrieve a list of additional IDs that are associated to the specified Song.

Allowed:

relationships

array of strings

Retrieve a list of entities that are associated to the specified Song. Multiple values can be entered in a single request (comma separated).

relationships

metrics

array of strings

Specify the desired consumption metrics in the output. Multiple values can be entered in a single request (comma separated). Specifying "none" would exclude all of the consumption data and return only the Song metadata.

metrics

atd

array of strings

ATD (activity-to-date) will provide a value that reflects all of the historical activity for the corresponding metric up to the end_date in the request. Multiple values can be entered in a single request (comma separated).

atd

breakouts

array of strings

Breakouts are categorizations of the consumption data. For this endpoint, breakouts are available only for the streaming data. Specify which of the streaming breakouts are included in the response. Multiple values can be entered in a single request (comma separated).

breakouts

aggregate_interval

string

enum

This parameter enables additional time-based aggregations of consumption data that are shown instead of the "total" value.

Allowed:

markets

array of strings

Retrieve the consumption data for one or multiple markets in the United States or Canada. Note: The Location ID and Market ID must correspond. Full list of supported markets can be found in the "Luminate IDs" folder in the Guides tab.

markets

market_filter

array of strings

Filter the consumption data by one or multiple markets.

market_filter

commercial_model

string

enum

Filter the streaming data by ad-supported or premium streams.

Allowed:

service_type

string

enum

Filter the streaming data by on-demand or programmed streams.

Allowed:

content_type

string

enum

Filter the streaming data by audio or video streams. Note: Content Type data is only available in the following locations: US, CA, AA.

Allowed:

airplay_formats

array of strings

Retrieve the airplay data for one or multiple airplay formats. Full list of supported airplay formats can be found in the "Luminate IDs" folder in the Guides tab.

airplay_formats

airplay_format_filter

string

Filter the airplay data by an airplay format.

Headers

string

enum

Allowed:

Response

200OK