music nerd

Artist lookupsSearch artists

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.

POST/api/searchArtists
POST/api/searchArtists

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
cURL
curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/searchArtists' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "Example Artist",
  "bookmarkedArtistIds": []
}'

Send the request to see the live response here.

Authorizations

None. This endpoint is public.

Body

application/jsonrequired
querystringrequired

Artist 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/json

Ranked 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>required
Item properties for results
oneOf · SearchArtistResult 1

A Music Nerd artist in search results.

idstringrequired

format: uuid

namestring | nullrequired
spotifystring | nullrequired
deezerstring | nullrequired
bandcampstring | nullrequired
youtubestring | nullrequired
youtubechannelstring | nullrequired
instagramstring | nullrequired
xstring | nullrequired
facebookstring | nullrequired
tiktokstring | nullrequired
customImagestring | nullrequired
match_typeintegerrequired

0 for a substring match on the name, 1 for a similarity match.

bionullrequired

Always null; the About comes from the claim-checked lookups.

isExternalOnlybooleanrequired
imageUrlstring | nullrequired

The artist's upload, else their Spotify or Deezer picture.

matchScoreintegerrequired

0 exact, 1 prefix, 2 substring, 3 similarity only.

linkCountintegerrequired

How many of the returned link columns are set.

oneOf · ExternalArtistResult 2

A Spotify or Deezer artist not yet in Music Nerd.

idnullrequired
namestringrequired
platformIdstringrequired
platformstring · enumrequired

Values: "spotify", "deezer"

imageUrlstring | nullrequired
profileUrlstringrequired
isExternalOnlybooleanrequired
matchScoreintegerrequired
linkCountintegerrequired