# Find an artist by Spotify ID

Source: https://docs.musicnerd.net/api-reference/lookups/find-artist-by-spotify-id

Find an artist by Spotify ID

## POST /api/findArtistBySpotifyID

Full OpenAPI specification: https://docs.musicnerd.net/spec/artist-lookups.json

## Authentication

This operation's specification permits a request without authentication.

[Authentication guide](https://docs.musicnerd.net/authentication)

## Operation and referenced schemas

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Music Nerd API: artist lookups",
    "version": "1.0.0",
    "description": "Find an artist by Spotify ID or Instagram handle, or an artist's X handle. No credentials."
  },
  "servers": [
    {
      "url": "https://musicnerd-api.vercel.app",
      "description": "Production"
    },
    {
      "url": "https://musicnerd-api-staging.vercel.app",
      "description": "Staging (staging database)"
    }
  ],
  "paths": {
    "/api/findArtistBySpotifyID": {
      "post": {
        "summary": "Find an artist by Spotify ID",
        "description": "Returns the artist whose `spotify` equals `spotifyID` exactly (case-sensitive). If several match, the first is returned. No credentials.\n\nResponses are `{ result }` with plain-text errors, not this API's `{ status }` envelope.",
        "operationId": "findArtistBySpotifyID",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "spotifyID"
                ],
                "properties": {
                  "spotifyID": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "spotifyID": "4Z8W4fKeB5YxbusRsdQVPb"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The matching artist.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "result"
                  ],
                  "properties": {
                    "result": {
                      "$ref": "#/components/schemas/Artist"
                    }
                  }
                },
                "example": {
                  "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
                  }
                }
              }
            }
          },
          "400": {
            "description": "`spotifyID` is missing or not a string, or the body is not JSON.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Missing or invalid required parameters: spotifyID"
              }
            }
          },
          "404": {
            "description": "No artist has that value.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "The artist you're searching for is not found"
              }
            }
          },
          "500": {
            "description": "The database could not be read.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Something went wrong on our end"
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Artist": {
        "type": "object",
        "description": "The artist's full record, including internal fields (`notes`, `addedBy`, `legacyId`, `webmapdata`).",
        "required": [
          "id",
          "legacyId",
          "bandcamp",
          "facebook",
          "x",
          "soundcloud",
          "notes",
          "patreon",
          "name",
          "instagram",
          "youtube",
          "youtubechannel",
          "lcname",
          "soundcloudId",
          "spotify",
          "twitch",
          "imdb",
          "musicbrainz",
          "wikidata",
          "mixcloud",
          "facebookId",
          "discogs",
          "tiktok",
          "tiktokId",
          "jaxsta",
          "famousbirthdays",
          "songexploder",
          "colorsxstudios",
          "bandsintown",
          "linktree",
          "onlyfans",
          "wikipedia",
          "audius",
          "zora",
          "catalog",
          "opensea",
          "foundation",
          "lastfm",
          "linkedin",
          "soundxyz",
          "mirror",
          "glassnode",
          "collectsNfTs",
          "spotifyusername",
          "bandcampfan",
          "tellie",
          "wallets",
          "ens",
          "lens",
          "addedBy",
          "cameo",
          "farcaster",
          "createdAt",
          "updatedAt",
          "supercollector",
          "bio",
          "customImage",
          "headerImagePosition",
          "linkOrder",
          "webmapdata",
          "nodePfp",
          "deezer",
          "subvert",
          "bluesky",
          "inprocess"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "legacyId": {
            "type": [
              "string",
              "null"
            ]
          },
          "bandcamp": {
            "type": [
              "string",
              "null"
            ]
          },
          "facebook": {
            "type": [
              "string",
              "null"
            ]
          },
          "x": {
            "type": [
              "string",
              "null"
            ]
          },
          "soundcloud": {
            "type": [
              "string",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "patreon": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "instagram": {
            "type": [
              "string",
              "null"
            ]
          },
          "youtube": {
            "type": [
              "string",
              "null"
            ]
          },
          "youtubechannel": {
            "type": [
              "string",
              "null"
            ]
          },
          "lcname": {
            "type": [
              "string",
              "null"
            ]
          },
          "soundcloudId": {
            "type": [
              "integer",
              "null"
            ]
          },
          "spotify": {
            "type": [
              "string",
              "null"
            ]
          },
          "twitch": {
            "type": [
              "string",
              "null"
            ]
          },
          "imdb": {
            "type": [
              "string",
              "null"
            ]
          },
          "musicbrainz": {
            "type": [
              "string",
              "null"
            ]
          },
          "wikidata": {
            "type": [
              "string",
              "null"
            ]
          },
          "mixcloud": {
            "type": [
              "string",
              "null"
            ]
          },
          "facebookId": {
            "type": [
              "string",
              "null"
            ]
          },
          "discogs": {
            "type": [
              "string",
              "null"
            ]
          },
          "tiktok": {
            "type": [
              "string",
              "null"
            ]
          },
          "tiktokId": {
            "type": [
              "string",
              "null"
            ]
          },
          "jaxsta": {
            "type": [
              "string",
              "null"
            ]
          },
          "famousbirthdays": {
            "type": [
              "string",
              "null"
            ]
          },
          "songexploder": {
            "type": [
              "string",
              "null"
            ]
          },
          "colorsxstudios": {
            "type": [
              "string",
              "null"
            ]
          },
          "bandsintown": {
            "type": [
              "string",
              "null"
            ]
          },
          "linktree": {
            "type": [
              "string",
              "null"
            ]
          },
          "onlyfans": {
            "type": [
              "string",
              "null"
            ]
          },
          "wikipedia": {
            "type": [
              "string",
              "null"
            ]
          },
          "audius": {
            "type": [
              "string",
              "null"
            ]
          },
          "zora": {
            "type": [
              "string",
              "null"
            ]
          },
          "catalog": {
            "type": [
              "string",
              "null"
            ]
          },
          "opensea": {
            "type": [
              "string",
              "null"
            ]
          },
          "foundation": {
            "type": [
              "string",
              "null"
            ]
          },
          "lastfm": {
            "type": [
              "string",
              "null"
            ]
          },
          "linkedin": {
            "type": [
              "string",
              "null"
            ]
          },
          "soundxyz": {
            "type": [
              "string",
              "null"
            ]
          },
          "mirror": {
            "type": [
              "string",
              "null"
            ]
          },
          "glassnode": {
            "type": [
              "string",
              "null"
            ]
          },
          "collectsNfTs": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "spotifyusername": {
            "type": [
              "string",
              "null"
            ]
          },
          "bandcampfan": {
            "type": [
              "string",
              "null"
            ]
          },
          "tellie": {
            "type": [
              "string",
              "null"
            ]
          },
          "wallets": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "ens": {
            "type": [
              "string",
              "null"
            ]
          },
          "lens": {
            "type": [
              "string",
              "null"
            ]
          },
          "addedBy": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "cameo": {
            "type": [
              "string",
              "null"
            ]
          },
          "farcaster": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postgres timestamp text, e.g. `2024-05-01 12:00:00.123+00`."
          },
          "updatedAt": {
            "type": "string",
            "description": "Postgres timestamp text."
          },
          "supercollector": {
            "type": [
              "string",
              "null"
            ]
          },
          "bio": {
            "type": [
              "string",
              "null"
            ]
          },
          "customImage": {
            "type": [
              "string",
              "null"
            ]
          },
          "headerImagePosition": {},
          "linkOrder": {},
          "webmapdata": {},
          "nodePfp": {},
          "deezer": {
            "type": [
              "string",
              "null"
            ]
          },
          "subvert": {
            "type": [
              "string",
              "null"
            ]
          },
          "bluesky": {
            "type": [
              "string",
              "null"
            ]
          },
          "inprocess": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
```