Skip to content

Search Apple Music and YouTube for songs

GET
/api/music/search
q
required

Search query

string
Example
Bohemian Rhapsody

Search query

providers

Comma-separated providers (apple_music, youtube)

string
Example
apple_music,youtube

Comma-separated providers (apple_music, youtube)

storefront

Apple Music storefront (ISO 3166-1 alpha-2)

string
Example
us

Apple Music storefront (ISO 3166-1 alpha-2)

Search results

object
ok
required
boolean
data
required
object
results
required
Array<object>
object
provider
required
string
Allowed values: apple_music youtube
title
required
string
artist
required
string
thumbnailUrl
required
string
nullable
mediaUrl
required
string
errors
Array<string>

Bad request / invalid query

object
ok
required
boolean
error
required
string
code
string

Unauthenticated

object
ok
required
boolean
error
required
string
code
string

Forbidden

object
ok
required
boolean
error
required
string
code
string

Rate limited

object
ok
required
boolean
error
required
string
code
string