Docs
APISearch

Search the catalogue

Cross-category keyword search over songs, artists and labels. The same search that backs the site header.

GET
/v1/search

Query Parameters

q*string

The keyword. Required, and capped in length.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/search?q=string"
{  "data": {    "songs": [      {        "id": -9007199254740991,        "title": "string",        "slug": "string",        "released_at": "string",        "artwork_url": "string",        "artwork_source": "Custom",        "youtube_video_id": "string",        "youtube_video_url": "string",        "artists": [          {            "id": -9007199254740991,            "name": "string"          }        ]      }    ],    "artists": [      {        "id": -9007199254740991,        "name": "string",        "slug": "string",        "prefix_title": "string",        "is_group": true,        "total_songs": -9007199254740991,        "total_credits": -9007199254740991,        "disambiguator": "string",        "avatar_url": "string"      }    ],    "labels": [      {        "id": -9007199254740991,        "name": "string",        "slug": "string"      }    ]  }}