Headers
Get your API keyAPI key (`sfk_...`)
Optional Spotify artist id for the request.
min 1 chars · max 128 chars
Optional Spotify artist URL for the request.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the artist was found.
one of: found, not_found
Artist details when available.
Platform for this artist.
one of: spotify
Stable Spotify artist identifier.
min 1 chars
Public display name for the artist.
min 1 chars
Artist biography text when available.
Best available square avatar image URL when available.
Canonical public Spotify artist profile URL.
min 1 chars
Whether the artist is marked as verified on Spotify.
Outbound profile links when available.
Link label as shown on the artist profile.
min 1 chars
Outbound URL for this link.
min 1 chars
Artist metrics when available.
Follower count for the artist.
≥ 0
Monthly listener count when available.
≥ 0
Global popularity rank when available.
≥ 0
Top listener cities when available.
City name.
min 1 chars
ISO country code when available.
min 1 chars
Monthly listener count for this city when available.
≥ 0
Region code within the country when available.
Related artists when available (may be empty).
Related artist Spotify id.
min 1 chars
Related artist display name.
min 1 chars
Best available avatar URL for the related artist.
Canonical public Spotify URL for the related artist.
min 1 chars
Discography counts when available.
Number of albums listed in the artist discography.
≥ 0
Number of singles listed in the artist discography.
≥ 0
Number of compilations listed in the artist discography.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/spotify/artist?artistId=1uNFoZAHBGtllmzznpCI3s" \
-H "x-api-key: YOUR_API_KEY"Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.