Introducing the Instagram APIRead more →
Sign inStart for freeDashboard

Spotify Artist API. Send an artist link.

Monthly listeners, top cities and releases. We handle the proxies, blocks and platform changes.

Get API key

Spotify Artist API at a glance

Returns a public Spotify artist from its link, URI or ID, with exact followers, monthly listeners, world rank and the top cities its listeners are in. It also has the bio, pictures, verified badge, top tracks with their plays, every release ID in its discography, related artists, upcoming concerts, playlists and the links on its profile.

GET /v1/spotify/artist

Read the API reference
  • 1 credit per request, $0.75–$1.97 per 1,000 requests
  • 19 typed fields null when unknown
  • handle is all it needs, e.g. https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt
  • 100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get 19 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap
handle = https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt
Open in playground
GET /v1/spotify/artistTry in
const params = new URLSearchParams({
  handle: "https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt",
});
const res = await fetch(`https://socialtap.dev/v1/spotify/artist?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
200 OK · GET https://socialtap.dev/v1/spotify/artistLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 27 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

  • Null means unknown

    A field Spotify doesn't show is null, never zero or an empty string, so a real zero always means zero.

  • What it accepts

    The artist: its link (open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt, also under /intl-de/ or /embed/, on any tab such as /discography/all or /about, with any share parameters), its URI (spotify:artist:0gxyHStUsqpMadRV0Di1Qt) or its 22-character ID.

  • Write one parser

    Spotify, TikTok, Instagram and 24 more platforms answer in these fields, so the code that reads one reads them all.

platformstring
Platform ID (tiktok, youtube, …).
idstring
Platform-native account ID (string; YouTube UC…, Reddit t2_…).
usernamestring
Handle without the @; null when the account has none.
display_namestring
Display name, channel title or page name; null when empty or not exposed.
urlstring
Canonical profile URL.
typestring
Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown.
biostring
Profile bio, channel description or page about text; null when empty or not exposed.
avatar_urlstring
Profile picture URL (largest available). Platform CDN URLs can expire within hours.

Live data from 33 platforms.

TikTokInstagramFacebookYouTubeRedditThreadsSpotifyAmazonApple MusicPinterestRumbleXBlueskyTwitchLinkedInTelegramTikTok ShopKwaiSnapchatSoundCloudTruth SocialKickKomiLnk.BioLinkmeLinktreePillarTikTok Ad LibraryFacebook Ad LibraryFacebook EventsFacebook MarketplaceGoogle Ads Transparency CenterLinkedIn Ad Library

What teams build with the Spotify Artist API.

  • Track monthly listeners over time

  • Map where an artist's listeners live

  • List an artist's releases to fetch each one

  • Find an artist's socials and upcoming concerts

  • Build a related-artists graph

Good to know before you build.

  • An artist has an ID and no username, so username is null.
  • Monthly listeners are in platform_specific.spotify and followers in metrics.follower_count. metrics.following_count, post_count and the totals are null because Spotify doesn't state them.
  • type is unknown, and is_private, category, location, country_code and created_at are null: Spotify doesn't state them for an artist.
  • Each discography section lists what the artist's page shows, total_count says how many there are, and ids holds every release ID, each one the Spotify Album API takes.
  • When Spotify's main API fails, the embed page answers with the name, picture and top tracks only. The rest is null or listed in unknown_fields.
  • Share links (spotify.link) aren't accepted: send the artist link they open.

1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packsHow this endpoint is pricedHow credits work

SourcePrice per successful requestPer 1,000 requests
Platform API api1 credit$0.75–$1.97
Public page page1 credit$0.75–$1.97
  • Cache hits are free.
  • Credits from packs and top-ups never expire.
  • A monthly plan's credits are spent first, and what is left of them ends at each renewal.
  • Prices exclude tax: sales tax is added at checkout where it applies.
  • Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Spotify Artist API.

More in the API reference.

Does it return monthly listeners?
Yes. platform_specific.spotify has the exact monthly listener count, with the artist's world rank and the cities its listeners are in.
How much does the Spotify Artist API cost?
A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

100free credits
  • No credit card
  • Failed requests are free
  • Works on all 218 endpoints
Start for free Read the docs