Skip to main content
GET
cURL

Query Parameters

q
string
required

Required search text, such as an artist or track name. For a Spotify artist URL use the lookup endpoint.

type
enum<string>
default:artists

Entity type to search: artists, tracks, or labels.

Available options:
artists,
tracks,
labels,
artist,
track,
label
limit
string
default:10

Raw pagination string forwarded to the configured research data connection. Recoup defaults limit to 10; offset is omitted when absent. Provider limits apply.

offset
string

Raw pagination string forwarded to the configured research data connection. Recoup defaults limit to 10; offset is omitted when absent. Provider limits apply.

Response

Search results

status
enum<string>
Available options:
success,
error
Example:

"success"

results
object[]

Matching artists, tracks or labels with provider identifiers and metadata.