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 on the artist page, up to 10. Not a catalogue total: check moreAlbumsMayExist.
≥ 0
Number of singles and EPs on the artist page, up to 10. Not a catalogue total: check moreSinglesMayExist.
≥ 0
Number of compilations on the artist page, up to 10. Not a catalogue total: check moreCompilationsMayExist.
≥ 0
True when the album list reached the page limit, so the artist may have more albums than listed.
True when the singles list reached the page limit, so the artist may have more singles than listed.
True when the compilation list reached the page limit, so the artist may have more compilations than listed.
Releases on the artist page when available.
Albums on the artist page, newest first, up to 10.
Spotify album id. Pass it to the Spotify album endpoint for per-track play counts.
min 1 chars
Release title.
min 1 chars
Release type (album, single, compilation, etc.).
one of: album, single, compilation, ep, unknown
Release date as ISO 8601 (YYYY-MM-DD, YYYY-MM or YYYY, matching releaseDatePrecision) when available.
Precision of the release date when available.
one of: day, month, year
Number of tracks on the release when available.
≥ 0
Best available square cover image URL when available.
Public Spotify album URL.
min 1 chars
Singles and EPs on the artist page, newest first, up to 10.
Spotify album id. Pass it to the Spotify album endpoint for per-track play counts.
min 1 chars
Release title.
min 1 chars
Release type (album, single, compilation, etc.).
one of: album, single, compilation, ep, unknown
Release date as ISO 8601 (YYYY-MM-DD, YYYY-MM or YYYY, matching releaseDatePrecision) when available.
Precision of the release date when available.
one of: day, month, year
Number of tracks on the release when available.
≥ 0
Best available square cover image URL when available.
Public Spotify album URL.
min 1 chars
Compilations on the artist page, newest first, up to 10.
Spotify album id. Pass it to the Spotify album endpoint for per-track play counts.
min 1 chars
Release title.
min 1 chars
Release type (album, single, compilation, etc.).
one of: album, single, compilation, ep, unknown
Release date as ISO 8601 (YYYY-MM-DD, YYYY-MM or YYYY, matching releaseDatePrecision) when available.
Precision of the release date when available.
one of: day, month, year
Number of tracks on the release when available.
≥ 0
Best available square cover image URL when available.
Public Spotify album URL.
min 1 chars
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/spotify/artist?artistId=1uNFoZAHBGtllmzznpCI3s" \
-H "x-api-key: YOUR_API_KEY"Responses
Artist lookup result.