Artist lookups

Find an artist by Spotify ID

Returns the artist whose spotify equals spotifyID exactly (case-sensitive). If several match, the first is returned. No credentials.

Responses are { result } with plain-text errors, not this API's { status } envelope.

POST/api/findArtistBySpotifyID

POST

POST/api/findArtistBySpotifyID

Returns the artist whose spotify equals spotifyID exactly (case-sensitive). If several match, the first is returned. No credentials.

Body

bodyapplication/json

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/findArtistBySpotifyID' \
  --header 'Content-Type: application/json' \
  --data '{
  "spotifyID": "4Z8W4fKeB5YxbusRsdQVPb"
}'

Send the request to see the live response here.

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/findArtistBySpotifyID' \
  --header 'Content-Type: application/json' \
  --data '{
  "spotifyID": "4Z8W4fKeB5YxbusRsdQVPb"
}'

{
  "result": {
    "id": "6cb3d81a-0000-4000-8000-000000000000",
    "legacyId": null,
    "bandcamp": null,
    "facebook": null,
    "x": "exampleartist",
    "soundcloud": null,
    "notes": null,
    "patreon": null,
    "name": "Example Artist",
    "instagram": "exampleartist",
    "youtube": null,
    "youtubechannel": null,
    "lcname": "example artist",
    "soundcloudId": null,
    "spotify": "4Z8W4fKeB5YxbusRsdQVPb",
    "twitch": null,
    "imdb": null,
    "musicbrainz": null,
    "wikidata": null,
    "mixcloud": null,
    "facebookId": null,
    "discogs": null,
    "tiktok": null,
    "tiktokId": null,
    "jaxsta": null,
    "famousbirthdays": null,
    "songexploder": null,
    "colorsxstudios": null,
    "bandsintown": null,
    "linktree": null,
    "onlyfans": null,
    "wikipedia": null,
    "audius": null,
    "zora": null,
    "catalog": null,
    "opensea": null,
    "foundation": null,
    "lastfm": null,
    "linkedin": null,
    "soundxyz": null,
    "mirror": null,
    "glassnode": null,
    "collectsNfTs": null,
    "spotifyusername": null,
    "bandcampfan": null,
    "tellie": null,
    "wallets": null,
    "ens": null,
    "lens": null,
    "addedBy": null,
    "cameo": null,
    "farcaster": null,
    "createdAt": "2024-05-01 12:00:00.123+00",
    "updatedAt": "2026-10-01 12:00:00.123+00",
    "supercollector": null,
    "bio": null,
    "customImage": null,
    "headerImagePosition": null,
    "linkOrder": null,
    "webmapdata": null,
    "nodePfp": null,
    "deezer": null,
    "subvert": null,
    "bluesky": null,
    "inprocess": null
  }
}

Authorizations

None. This endpoint is public.

Body

application/jsonrequired

spotifyIDstringrequired

Response

application/json

The matching artist.

resultobjectrequired

The artist's full record, including internal fields (notes, addedBy, legacyId, webmapdata).

Properties

idstringrequired

format: uuid

legacyIdstring | nullrequired

bandcampstring | nullrequired

facebookstring | nullrequired

xstring | nullrequired

soundcloudstring | nullrequired

notesstring | nullrequired

patreonstring | nullrequired

namestring | nullrequired

instagramstring | nullrequired

youtubestring | nullrequired

youtubechannelstring | nullrequired

lcnamestring | nullrequired

soundcloudIdinteger | nullrequired

spotifystring | nullrequired

twitchstring | nullrequired

imdbstring | nullrequired

musicbrainzstring | nullrequired

wikidatastring | nullrequired

mixcloudstring | nullrequired

facebookIdstring | nullrequired

discogsstring | nullrequired

tiktokstring | nullrequired

tiktokIdstring | nullrequired

jaxstastring | nullrequired

famousbirthdaysstring | nullrequired

songexploderstring | nullrequired

colorsxstudiosstring | nullrequired

bandsintownstring | nullrequired

linktreestring | nullrequired

onlyfansstring | nullrequired

wikipediastring | nullrequired

audiusstring | nullrequired

zorastring | nullrequired

catalogstring | nullrequired

openseastring | nullrequired

foundationstring | nullrequired

lastfmstring | nullrequired

linkedinstring | nullrequired

soundxyzstring | nullrequired

mirrorstring | nullrequired

glassnodestring | nullrequired

collectsNfTsboolean | nullrequired

spotifyusernamestring | nullrequired

bandcampfanstring | nullrequired

telliestring | nullrequired

walletsarray | nullrequired

Properties

string

ensstring | nullrequired

lensstring | nullrequired

addedBystring | nullrequired

format: uuid

cameostring | nullrequired

farcasterstring | nullrequired

createdAtstring | nullrequired

Postgres timestamp text, e.g. 2024-05-01 12:00:00.123+00.

updatedAtstringrequired

Postgres timestamp text.

supercollectorstring | nullrequired

biostring | nullrequired

customImagestring | nullrequired

headerImagePositionanyrequired

linkOrderanyrequired

webmapdataanyrequired

nodePfpanyrequired

deezerstring | nullrequired

subvertstring | nullrequired

blueskystring | nullrequired

inprocessstring | nullrequired