Guia
API de ouvintes mensais do Spotify: ouvintes, seguidores, ranking mundial e principais cidades por artista
O número abaixo do nome de cada artista no app do Spotify — os ouvintes mensais — não está na Web API. O objeto de artista oficial traz, no máximo, o número de seguidores e uma nota de popularidade de 0 a 100, nada mais sobre o público, e o Spotify marca ambos como descontinuados e os removeu para apps em modo de desenvolvimento criados a partir de 11 de fevereiro de 2026. Uma chamada aqui retorna ouvintes, seguidores, um ranking mundial e as cinco cidades onde o artista mais é tocado.
Por Eduardo Airaudo, mantenedor da API · Atualizado em 22 de outubro de 2026
O que o objeto de artista oficial deixa de fora
GET /v1/artists/{id} na Web API do Spotify retorna followers.total, um inteiro popularity, gêneros, imagens e um nome — os três primeiros marcados como descontinuados, e seguidores e popularidade removidos para apps em modo de desenvolvimento criados a partir de 11 de fevereiro de 2026. Os ouvintes mensais — o número que o próprio Spotify coloca na página do artista e o que gravadoras, empresários e quem faz pitch para playlists realmente acompanham — não aparecem em lugar nenhum da referência, e nenhum escopo os adiciona.
A popularidade é uma nota relativa e opaca, recalculada pelo Spotify a partir de reproduções recentes; não dá para convertê-la em ouvintes, compará-la entre meses nem explicá-la a um cliente. Ouvintes mensais é uma contagem absoluta que se move com um lançamento, uma sincronização em audiovisual ou uma entrada em playlist, e por isso é o número que as pessoas querem.
/artist_overview aqui retorna a página do artista como o app a renderiza, com o bloco de público incluído. A mesma chamada traz a discografia, os artistas relacionados e os itens fixados, então os números de público vêm com o contexto necessário para lê-los.
O que volta
Extraído da resposta gravada de /artist_overview para Arijit Singh (4YRxDV8wJFPHPTeXepOstw), capturada em 2026-10-22. A gravação completa está na página do próprio endpoint.
- stats.monthlyListeners
- O número de público na página do artista: ouvintes distintos nos últimos 28 dias, como inteiro. 53.500.280 na gravação.
- stats.followers
- Número de seguidores. O Spotify o removeu do próprio objeto de artista para apps em modo de desenvolvimento criados a partir de 11 de fevereiro de 2026; apps com cota estendida ainda o recebem. 195.766.074 na gravação.
- stats.worldRank
- A posição do artista no ranking global do Spotify por ouvintes — 56 na gravação. Ausente para artistas fora do conjunto ranqueado.
- stats.topCities.items[]
- Cinco linhas com city, region, country e numberOfListeners. A gravação abre com Pune, IN com 4.174.171 ouvintes, depois Delhi, New Delhi, Mumbai e Bengaluru.
- profile.name
- Nome de exibição. A gravação também traz a biografia, uma lista externalLinks (vazia para este artista), o item fixado e as playlists do próprio artista em profile, e nenhum indicador de verificado.
- discography, relatedContent
- Último lançamento, álbuns, singles, aparece em e o bloco de artistas relacionados, na mesma resposta — uma chamada cobre a página inteira do artista.
53.500.280
stats.monthlyListeners
195.766.074
stats.followers
#56
stats.worldRank
Três números de uma gravação, 2026-10-22. Eles aparecem para tornar o formato concreto, não como números atuais — aperte Executar na página do endpoint para ver os de hoje.
Um artista, 10 artistas ou um ranking
- Artist overviewGET /artist_overview
- Artist overview (batch)GET /artist_overview_batch
- Most-listened artists (monthly listeners)GET /top_20_by_monthly_listeners
- Most-followed artistsGET /top_20_by_followers
/artist_overview_batch recebe até 10 IDs separados por vírgula e retorna o mesmo objeto para cada artista, então 10 artistas custam uma requisição em vez de 10.
Nas palavras da especificação, /top_20_by_monthly_listeners é “Wikipedia's list of the most-streamed artists on Spotify: up to 50 rows of {rank, artist, monthlyListeners}, where monthlyListeners is in millions (129.8 means 129,800,000). Not country-specific” e /top_20_by_followers é “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Nenhum dos dois recebe parâmetros.
A resposta gravada de ouvintes, capturada em 2026-10-22, tem 50 linhas com rank, artist e monthlyListeners expressos em milhões — a primeira linha mostra Bruno Mars com 128,6.
Buscar os números de público de um artista
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
O ID é a sequência de 22 caracteres depois de /artist/ em qualquer URL do Spotify. Tem um nome em vez do ID? /search?q=&type=artists retorna o ID.
Acompanhando o número ao longo do tempo
O Spotify publica um único valor atual, não um histórico. A série temporal fica por sua conta: chame /artist_overview em um agendamento, guarde stats.monthlyListeners com um carimbo de data e hora e calcule a diferença entre as linhas. Um job diário para um elenco de 25 artistas são 3 requisições em lote por dia — 90 requisições por mês, dentro das 1.000 do plano gratuito.
Para que a API guarde o histórico, /tracking/track?spotifyType=artist&spotifyId= registra o artista; as linhas de monthly_listeners_change e followers_change dele se acumulam em /tracking/logs, que você consulta. Os webhooks cobrem apenas mudanças em playlists. Ambos estão na referência em Tracking; são endpoints operacionais, então a demonstração deste site não os executa.
Sem código: Spotify Monthly Listeners Scraper (opens in a new tab) on Apify returns monthly listeners, followers, world rank and top cities for any artist. spotify-monthly-listeners (opens in a new tab) on GitHub has daily monthly listeners, followers and world rank for 500 artists, as CSV and JSON history.
Perguntas
A Web API do Spotify retorna ouvintes mensais?
Não. O objeto de artista na referência da Web API lista followers.total, popularidade, gêneros, imagens e um nome. Os três primeiros estão marcados como descontinuados, e seguidores e popularidade foram removidos para apps em modo de desenvolvimento criados a partir de 11 de fevereiro de 2026. Os ouvintes mensais aparecem nos clientes do próprio Spotify, mas não fazem parte da API documentada, e nenhum escopo OAuth os expõe.
Quão atual é o número?
As visões gerais de artistas ficam em cache por cerca de uma hora, então uma resposta pode ficar atrás do número do app do Spotify por até esse tempo. Adicione cache=false para forçar uma busca nova; o cabeçalho X-Cache informa como cada resposta foi servida. Os botões Executar deste site também passam pelo cache próprio da demonstração, então o valor ali pode ser mais antigo.
Posso obter os ouvintes mensais de vários artistas de uma vez?
Sim. GET /artist_overview_batch recebe até 10 IDs de artistas separados por vírgula e retorna o mesmo objeto de visão geral para cada um, então 10 artistas custam uma requisição. GET /artists?ids= também recebe uma lista, mas retorna o objeto de artista do próprio Spotify: sem ouvintes mensais e, para muitos artistas, sem número de seguidores também.
worldRank é uma posição global?
É o ranking que o próprio Spotify exibe na página do artista (“#56 no mundo” na gravação usada aqui). Artistas fora do conjunto ranqueado não têm o campo worldRank, então trate-o como opcional.
O que são as principais cidades?
stats.topCities.items lista as cinco cidades com mais ouvintes do artista, cada uma com city, region, country e numberOfListeners. É o mesmo bloco que a página do artista mostra em Sobre.
Posso obter o histórico dos ouvintes mensais de um artista?
Não pelo Spotify, que publica apenas o valor atual. Guarde o número em um agendamento e você terá o histórico a partir daquele dia; 3 chamadas em lote por dia para 25 artistas custam 90 requisições por mês.
De qual plano eu preciso?
De qualquer um. Os endpoints que este guia usa estão em todos os planos, tanto da RapidAPI quanto do portal direto, e os planos diferem pelo volume mensal. Todo plano da RapidAPI permite 5 requisições por segundo e toda chave direta inclui 10. O plano gratuito da RapidAPI permite 1.000 requisições por mês.
Fontes
- Get Artist — referência da Web API do Spotify — o objeto de artista oficial: seguidores, popularidade e gêneros marcados como descontinuados; sem campo de ouvintes mensais.
- Mudanças de fevereiro de 2026 — referência do Spotify for Developers — seguidores e popularidade de artistas removidos para apps em modo de desenvolvimento criados a partir de 11 de fevereiro de 2026.
- GET /artist_overview neste site — a resposta gravada de onde esta página lê, completa, com a data de captura.
- GET /top_20_by_monthly_listeners neste site — o ranking da plataforma, com a própria gravação.
More guides
- Spotify Web API alternativeEndpoint-by-endpoint mapping from the official API, including everything Spotify removed on 27 November 2024.
- Spotify API without OAuthOne header instead of the client-credentials flow — and the things a key genuinely cannot do.
- Spotify lyrics APIWhy the Web API has no lyrics endpoint, and how to get line-synced lyrics as JSON, LRC or SRT.
- Spotify charts APIDaily Top 200 and viral charts as JSON: rank movement, stream counts, credits, and how to backfill.
- Spotify play count APILifetime streams for any track, by Spotify id or ISRC, one or a batch per call — and why a 0 means under 1,000.
- Spotify audio features API after the 2024 deprecationTempo, energy, danceability, recommendations and related artists after Spotify removed them for new apps.
- Spotify API rate limitsThe official 30-second rolling window, what each plan here allows per second and per month, and how to stay under it.
- Spotify scraper on ApifyPlay counts, charts, lyrics and credits as a scheduled run with no API key — and when an API key is the better tool.
- Spotify MCP serverPlay counts, monthly listeners and charts inside Claude, Cursor or VS Code: an open-source MCP server that runs with your own key.
What changed in the API and on these pages, and when: What's new.
Obtenha uma chave e puxe seu primeiro artista
Os mesmos endpoints nos três canais, com preços diferentes. O plano gratuito da RapidAPI tem 1.000 requisições por mês — o suficiente para acompanhar um elenco todo dia.
Ainda não quer comprar? Receber uma chave de teste grátis: 500 requisições em 7 dias, sem cartão.