Skip to main content
GET
Search for an artist on the primary catalog provider
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

GET /catalog-import/search Description: Free-text artist search against the active provider that supports searchArtist (the primary catalog provider is preferred). Used to resolve a human-readable artist name to the artistExternalId required by POST /fetch. If q looks like an ISRC, it is resolved to the recording’s credited artists first, then those names are searched (identifier-shaped free-text queries otherwise return unrelated results). If q looks like a UPC/barcode, an empty result is returned — barcodes have no artist identity. Authorization:
  • Required role: admin or higher
Method: GET

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Query Parameters

q
string
required

Artist name, or an ISRC to resolve to its credited artists.

limit
integer
default:10

Maximum results to return (capped at 25).

Required range: 1 <= x <= 25

Response

Matching artists retrieved

status
string
Example:

"success"

data
object