Spotify Artist API
Resolve a public Spotify artist by Spotify ID or artist URL — display name, bio, followers, monthly listeners, and related artists in the same envelope as your social profile lookups.
GET /v1/spotify/artist1 credit per successful request.
About this endpoint
Music-aware creator and brand graphs need a stable Spotify artist ID beside TikTok and YouTube handles. Scraping open.spotify.com pages yourself means brittle HTML, geo quirks, and a second auth stack. You want a GET that takes an artist id or a public artist link and returns fields you can upsert.
`GET /v1/spotify/artist` accepts `artistId` or `url` (an `https://open.spotify.com/artist/...` link). Pass one identifier per request. The response uses the shared Social Fetch envelope — branch on `data.lookupStatus` before you write rows, keep `meta.requestId` for support, and bill from `meta.creditsCharged`. When status is `found`, you get artist identity fields, optional metrics (followers, monthly listeners, top cities when present), related artists, and a discography summary of album/single/compilation counts.
This route is a single-artist get. Album and track details use `GET /v1/spotify/album` and `GET /v1/spotify/track`. For playback, user libraries, and playlist write scopes, use Spotify's official Web API with developer credentials and OAuth.
Spotify Artist API FAQ
How do I look up a Spotify artist via API?
Call GET /v1/spotify/artist with your Social Fetch API key (x-api-key) and either artistId or url. Read data.lookupStatus before writing rows. Full parameters and examples are in the API docs.
What identifiers does the Spotify Artist API accept?
A Spotify artist id, or a public open.spotify.com/artist/... URL. One of artistId or url is required. Pass one identifier per request — do not send conflicting values on the same call.
How much does Spotify artist lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What fields does the Spotify artist response include?
When lookupStatus is found: artist identity (artistId, displayName, bio, avatar, profile URL, verified flag, external links when present), metrics such as followers and monthly listeners when available, related artists, and optional discography counts. Coverage follows public catalog data — private or user-library scopes are out of scope.
Does HTTP 200 always mean the artist was found?
No. HTTP 200 means the request finished. Check data.lookupStatus: found means you got an artist card; not_found means the identifier did not resolve. Persist meta.requestId when you need to debug a miss.
Spotify Web API vs Social Fetch for artist lookup?
Spotify Web API is Spotify's official product with developer apps, quotas, and OAuth for user-authorized features. Social Fetch is a third-party public-catalog API with credit metering and a unified response shape across platforms. Prefer Spotify official when you need playback, playlists you manage, or user library access.
Can I fetch albums or tracks on this route?
No. This endpoint returns artist details (plus related artists and discography counts when present). Use GET /v1/spotify/album for an album and GET /v1/spotify/track for a track. All share one Social Fetch API key with the rest of the Spotify tag.