Artist lookups
Search artists
Searches Music Nerd and Deezer by name, or resolves a Spotify/Deezer artist ID or artist URL. Exact saved provider ownership is returned first without a direct provider lookup. Saved explicit URLs/URIs need no provider requests. Bare IDs also run the normal ranked name search so numeric artist names remain searchable, including when direct lookup is unavailable. Conflicting saved ownership returns 409 instead of presenting either profile as authoritative. Otherwise a direct lookup returns an external result for the existing add/review flow, without creating or linking an artist.
Body
application/jsonrequiredquerystringrequiredArtist name, 22-character Spotify ID, positive numeric Deezer ID, spotify:artist:<id>, or an HTTPS artist URL on open.spotify.com or deezer.com (including locale paths and share parameters). Track/album URLs and unsupported URLs return 400; short redirect links are not followed.
bookmarkedArtistIdsarray<string>Artists the caller has bookmarked; they rank first within a match tier.
Item properties for bookmarkedArtistIds
string
Response
application/jsonRanked name results or exact provider identity results. Local artists carry public identity/link columns with bio null; external artists have id null. A missing provider artist returns no direct result. Bare inputs retain usable local/external name matches even when direct lookup is unavailable, and are not cached so a later request can recover the direct identity.
resultsarray<one of>requiredItem properties for results
oneOf · SearchArtistResult 1
A Music Nerd artist in search results.
idstringrequiredformat: uuid
namestring | nullrequiredspotifystring | nullrequireddeezerstring | nullrequiredbandcampstring | nullrequiredyoutubestring | nullrequiredyoutubechannelstring | nullrequiredinstagramstring | nullrequiredxstring | nullrequiredfacebookstring | nullrequiredtiktokstring | nullrequiredcustomImagestring | nullrequiredmatch_typeintegerrequired0 for a substring match on the name, 1 for a similarity match.
bionullrequiredAlways null; the About comes from the claim-checked lookups.
isExternalOnlybooleanrequiredimageUrlstring | nullrequiredThe artist's upload, else their Spotify or Deezer picture.
matchScoreintegerrequired0 exact, 1 prefix, 2 substring, 3 similarity only.
linkCountintegerrequiredHow many of the returned link columns are set.
oneOf · ExternalArtistResult 2
A Spotify or Deezer artist not yet in Music Nerd.
idnullrequirednamestringrequiredplatformIdstringrequiredplatformstring · enumrequiredValues: "spotify", "deezer"
imageUrlstring | nullrequiredprofileUrlstringrequiredisExternalOnlybooleanrequiredmatchScoreintegerrequiredlinkCountintegerrequired