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

Match items into other services

POST/public/search/match
CoreAuthBasicTokenDevTokenDocsSession

Finds each track, album or artist that you name in the destination services. Needs no connected user.

Request body

application/json · required

destinations
string[]
requiredThe services to find each object in.
objects
CatalogObjectRef[]
required
objects[].id
string
requiredThe id of the track, album or artist on its service.
objects[].source
string
requiredA search source. GET /public/search/introspection lists them.

Response

200application/json · SearchMatchResponseOK
matches
object[]
required
matches[].object
object
requiredThe object you sent, with its catalogue data.
matches[].matches
object[]
requiredOne entry per destination that has the object.
Example answer
{
  "matches": [
    {
      "object": {},
      "matches": [
        {}
      ]
    }
  ]
}

Errors

400

A source or a destination is not a search source.