Skip to the content
Get an API key
  1. API reference
  2. Search and match the catalog

Search

POST/public/search
CoreAuthBasicTokenDevTokenDocsSession

Searches the catalogues of one or more services for a track, an album or an artist. Needs no connected user. Check which services return the ISRC.

Request body

application/json · required

type
string
requiredOne of: track, album, artist
track
string
Track title.
artist
string
Artist name.
album
string
Album title.
sources
string[]
requiredAt least one search source. GET /public/search/introspection lists the valid values.

Response

200application/json · PublicSearchResponseok
tracks
object[]
required
tracks[].source
string
required
tracks[].status
string
required
tracks[].data
object
required
tracks[].data.externalId
string
required
tracks[].data.name
string
required
tracks[].data.artistNames
string[] | null
required
tracks[].data.albumName
string | null
required
tracks[].data.imageUrl
string
required
tracks[].data.previewUrl
string | null
required
tracks[].data.isrc
string
required
tracks[].data.duration
number | null
required
tracks[].data.url
string
required
tracks[].type
string
required
Example answer
{
  "tracks": [
    {
      "source": "spotify",
      "status": "success",
      "data": {
        "externalId": "5aszL9hl6SBzFNsOvw8u8w",
        "name": "Bezos I",
        "artistNames": [
          "Bo Burnham"
        ],
        "albumName": "INSIDE",
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b27388fed14b936c38007a302413",
        "previewUrl": "string",
        "isrc": "",
        "duration": 58149,
        "url": "https://open.spotify.com/track/5aszL9hl6SBzFNsOvw8u8w"
      },
      "type": "track"
    }
  ]
}