Spotify

GET /v1/spotify/artist

Spotify Artist API

Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCount, concerts, and related artists (1 credit).

1 credit per request

Try in Playground Get your API key — free Read the docs

TL;DR

Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCount, concerts, and related artists (1 credit). The Spotify Artist API (Spotify) is a single authenticated GET request to /v1/spotify/artist that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the Spotify Artist API?

Pass a Spotify artist URL, URI, or ID and get a clean profile: name (track/artist title — not a profile displayName alias), description, image, followers, monthlyListeners, worldRank, topCities[{city,country,region,listeners}], externalLinks[], verified, topTracks[] (with playCount), concerts[], relatedArtists[], and albums[]/singles[] samples plus albumsCount/singlesCount and albumsHasMore/singlesHasMore. Flat 1 credit. monthlyListeners, topCities, and worldRank are not on Spotify's public Web API. The overview GraphQL only embeds a short discography sample — when HasMore is true, chain release URIs into /spotify/album. Pass raw=true only if you need the full upstream GraphQL payload (omitted by default — it is ~80% of the old response).

What you get

Display name, handle or URL, bio, and avatar when available
Follower / subscriber and content counts
Verification status and external links when exposed
Structured JSON ready for enrichment and dashboards

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

url*stringSpotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.rawoptionalbooleanInclude the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape (~80% of the old response body).cacheoptionalbooleanSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

API keyoptionalPaste your key to get a ready-to-run snippet. It stays in your browser.Sign in to run live

curl "https://api.captapi.com/v1/spotify/artist?url=https%3A%2F%2Fopen.spotify.com%2Fartist%2F06HL4z0CvFAxyc27GXpf02%3Fsi%3DojAujUioTXmCOg3l0f4rNg" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "platform": "spotify",
    "type": "artist",
    "uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02",
    "url": "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02?si=ojAujUioTXmCOg3l0f4rNg",
    "name": "Taylor Swift",
    "description": "And, baby, that’s show business for you. New album The Life of a Showgirl. Available now ❤️‍🔥",
    "followers": 161871951,
    "monthlyListeners": 100784802,
    "image": "https://i.scdn.co/image/ab6761610000e5ebe2e8e7ff002a4afda1c7147e",
    "worldRank": 6,
    "topCities": [
      {
        "city": "London",
        "country": "GB",
        "region": "ENG",
        "listeners": 1612075
      },
      {
        "city": "Quezon City",
        "country": "PH",
        "region": "00",
        "listeners": 1256007
      }
    ],
    "externalLinks": [
      {
        "name": "FACEBOOK",
        "url": "https://facebook.com/TaylorSwift"
      },
      {
        "name": "INSTAGRAM",
        "url": "https://instagram.com/taylorswift"
      }
    ],
    "verified": true,
    "topTracks": [
      {
        "name": "The Fate of Ophelia",
        "uri": "spotify:track:53iuhJlwXhSER5J2IYYv1W",
        "url": "https://open.spotify.com/track/53iuhJlwXhSER5J2IYYv1W",
        "playCount": 1571637645,
        "durationMs": 226073,
        "albumUri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I",
        "image": "https://i.scdn.co/image/ab67616d0000b273d7812467811a7da6e6a44902",
        "explicit": false
      },
      {
        "name": "I Knew It, I Knew You - From \"Toy Story 5\"",
        "uri": "spotify:track:5uPaqMMt59KGrdKIitDRqa",
        "url": "https://open.spotify.com/track/5uPaqMMt59KGrdKIitDRqa",
        "playCount": 137089953,
        "durationMs": 178186,
        "albumUri": "spotify:album:3ZLIShtR6Fjs4nTWFpBUB6",
        "image": "https://i.scdn.co/image/ab67616d0000b273a35a1d4983e2b4fd0094f910",
        "explicit": false
      }
    ],
    "concerts": [],
    "relatedArtists": [
      {
        "name": "Sabrina Carpenter",
        "uri": "spotify:artist:74KM79TiuVKeVCqs8QtB0B",
        "url": "https://open.spotify.com/artist/74KM79TiuVKeVCqs8QtB0B",
        "image": "https://i.scdn.co/image/ab6761610000e5eb78e45cfa4697ce3c437cb455"
      },
      {
        "name": "Ariana Grande",
        "uri": "spotify:artist:66CXWjxzNUsdJxJ2JdwvnR",
        "url": "https://open.spotify.com/artist/66CXWjxzNUsdJxJ2JdwvnR",
        "image": "https://i.scdn.co/image/ab6761610000e5eb766397ec42a573a53eb5fb87"
      }
    ],
    "albums": [
      {
        "name": "The Life of a Showgirl + Acoustic Collection",
        "uri": "spotify:album:6QNMhoV8V0u7cFuhhUBOn7",
        "url": "https://open.spotify.com/album/6QNMhoV8V0u7cFuhhUBOn7",
        "image": "https://i.scdn.co/image/ab67616d0000b273f756bdc2c11a985dc0c06d94",
        "releaseYear": 2025,
        "totalTracks": 19
      },
      {
        "name": "The Life of a Showgirl",
        "uri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I",
        "url": "https://open.spotify.com/album/4a6NzYL1YHRUgx9e3YZI6I",
        "image": "https://i.scdn.co/image/ab67616d0000b273d7812467811a7da6e6a44902",
        "releaseYear": 2025,
        "totalTracks": 12
      }
    ],
    "singles": [
      {
        "name": "I Knew It, I Knew You (From \"Toy Story 5\")",
        "uri": "spotify:album:4Ii9whWXI1O1H01ziECRaG",
        "url": "https://open.spotify.com/album/4Ii9whWXI1O1H01ziECRaG",
        "image": "https://i.scdn.co/image/ab67616d0000b273e8852f06eca817333d20e60b",
        "releaseYear": 2026,
        "totalTracks": 3
      },
      {
        "name": "Elizabeth Taylor",
        "uri": "spotify:album:71GTik4z9bbKKY2EmUvkDI",
        "url": "https://open.spotify.com/album/71GTik4z9bbKKY2EmUvkDI",
        "image": "https://i.scdn.co/image/ab67616d0000b273dc6e4c7774e0c77c210d3a31",
        "releaseYear": 2026,
        "totalTracks": 3
      }
    ],
    "albumsCount": 33,
    "singlesCount": 79,
    "albumsHasMore": true,
    "singlesHasMore": true,
    "id": "06HL4z0CvFAxyc27GXpf02"
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Top-level fields

platformAlways "spotify" on this endpoint.
typeContent type of the item.
uriPlatform URI for the item.
urlCanonical URL of the item.
nameArtist display name on Spotify. Not a deprecated displayName alias.
descriptionDescription text.
followersFollower count.
monthlyListenersMonthly listener count.
imageImage URL.
worldRankArtist global rank by monthly listeners (web-player GraphQL; not on Spotify's public Web API).
verifiedWhether the account is verified on this platform.
concertsUpcoming concerts with city, venue, and start time when Spotify exposes them.
albumsCountTotal album count for the artist.
singlesCountTotal singles/EP count for the artist.
albumsHasMoreTrue when albumsCount > len(albums[]) — overview sample is incomplete; chain into /spotify/album.
singlesHasMoreTrue when singlesCount > len(singles[]) — overview sample is incomplete; chain into /spotify/album.
idStable platform ID for the item.

Top cities

Each item in topCities contains:

cityCity. Example: "London".
countryISO country for a topCities listener city (e.g. US). Not a popular-creators feed market.
regionISO region/country for a topCities row (listener geography), not a request market.
listenersListener count for a city in topCities.

External links

Each item in externalLinks contains:

nameArtist display name on Spotify. Not a deprecated displayName alias.
urlCanonical URL of the item.

Top tracks

Each item in topTracks contains:

nameArtist display name on Spotify. Not a deprecated displayName alias.
uriPlatform URI for the item.
urlCanonical URL of the item.
playCountLifetime stream count for a topTracks[] row.
durationMsLength in milliseconds.
albumUriSpotify album URI for a track.
imageImage URL.
explicitConvenience boolean: true only when contentRating is EXPLICIT (or EXPLICIT is among contentRatingLabels).

Related artists

Each item in relatedArtists contains:

nameArtist display name on Spotify. Not a deprecated displayName alias.
uriPlatform URI for the item.
urlCanonical URL of the item.
imageImage URL.

Albums

Each item in albums contains:

nameArtist display name on Spotify. Not a deprecated displayName alias.
uriPlatform URI for the item.
urlCanonical URL of the item.
imageImage URL.
releaseYearYear of release.
totalTracksNumber of tracks.

Singles

Each item in singles contains:

nameArtist display name on Spotify. Not a deprecated displayName alias.
uriPlatform URI for the item.
urlCanonical URL of the item.
imageImage URL.
releaseYearYear of release.
totalTracksNumber of tracks.

Parameters

Name	Type	Required	Description
url	string	Yes	Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
raw	boolean	No	Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape (~80% of the old response body).
cache	boolean	No	Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.

Using an AI agent? This endpoint is the MCP tool spotify_artist via @captapi/mcp. Set it up →

How it works

1. Sign up — get 100 free credits, no card required.
2. Create a key from your dashboard.
3. Send one request to /v1/spotify/artist and parse the JSON response.

Use cases

Audience geography

Use monthlyListeners, worldRank, and topCities — fields Spotify's free Web API does not expose.

Hit tracks

Rank an artist's topTracks by playCount for A&R, playlisting, and competitive research.

Discography fan-out

When albumsHasMore/singlesHasMore, walk release URIs into /spotify/album for full catalog detail.

Frequently asked questions

What does the Spotify Artist API do?+

The Spotify Artist API lets you fetch profile or page details and audience stats from a public Spotify profile or page using one GET request to /v1/spotify/artist. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Spotify Artist API cost?+

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Spotify API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is this the same as Spotify's free Web API?+

No. Spotify's official Web API returns followers, popularity, genres, and top tracks, but not monthlyListeners, topCities, or worldRank. Those three come from the web-player GraphQL path this endpoint uses — along with topTracks playCount, concerts, and relatedArtists as clean JSON.

Why is raw omitted by default?+

raw is the full GraphQL payload (~80% of the old response) and every normalized field is already derived from it. Pass raw=true only when you need an upstream key we do not lift. It also duplicates itself internally (e.g. biography vs profile.biography).

Why are albums[] / singles[] shorter than albumsCount / singlesCount?+

queryArtistOverview only embeds a short discography sample. albumsHasMore / singlesHasMore are true when the catalog is larger — chain each release uri into /spotify/album. There is no discography cursor on this overview surface.

Is the Spotify Artist API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

More Spotify APIs

Spotify Track API Spotify Album API Spotify Search API Spotify Podcast API Spotify Podcast Episodes API

Ready to use the Spotify Artist API?

Get started free