Available radios on Soundcharts are listed in the Get radios endpoint.

Don't know the artist UUID yet? Use the Get artist by platform ID or Search artist by name endpoints.

Request

GET /api/v2/artist/{uuid}/broadcast-groups

Path parameters

Parameter name Value Description Additional
uuid string

An Artist UUID

Required

Query string parameters

Parameter name Value Description Additional
radioSlugs string

Optional radio slugs filter (comma separated)

countryCode string

Optional country code filter (2 letters ISO 3166-2, full list on https://en.wikipedia.org/wiki/ISO_3166-2)

startDate string

Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days

endDate string

Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days

offset integer

Get results starting from position

limit integer

Number of results (max. 100)

Response

Status code Description Resource
200 OK

A Broadcast Collection response

Broadcast Collection
400 Bad Request

Invalid request

401 Unauthorized

You are not logged in

403 Forbidden

This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access.

404 Not Found

Arist not found


Explore this api

uuid

An Artist UUID

radioSlugs

Optional radio slugs filter (comma separated)

countryCode

Optional country code filter (2 letters ISO 3166-2, full list on https://en.wikipedia.org/wiki/ISO_3166-2)

startDate

Optional period start date (format YYYY-MM-DD), period cannot exceed 90 days

endDate

Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days

offset

Get results starting from position

limit

Number of results (max. 100)

Try it out!