Gráfico circular do Spotify: como ver os teus géneros principais em 2026 (e que ferramentas ainda funcionam)

Um gráfico circular do Spotify é aquela roda de géneros que toda a gente publica em novembro: um círculo fatiado em indie rock, bedroom pop, hyperpop e meia dúzia de microgéneros de que nunca ouviste falar. Parece um veredicto sobre o teu gosto. Está mais perto de um boletim meteorológico das últimas semanas. E se o site de gráficos que usaste no ano passado agora encrava depois de iniciares sessão, a explicação quase de certeza não tem nada a ver com a tua conta.

A plataforma para programadores em que estes gráficos assentam mudou duas vezes. O Spotify cortou o acesso de novos casos de uso a um conjunto de endpoints da Web API e, depois, voltou a apertar o modo de desenvolvimento na ronda de alterações descrita no guia de migração de fevereiro de 2026. Ambas as mudanças definem o que um gráfico de géneros te consegue mostrar hoje.

Um gráfico circular, o Wrapped e as estatísticas todo o ano medem coisas diferentes

Três janelas diferentes, três regras de ordenação diferentes. É só por isso que o teu gráfico, o teu Wrapped e a tua memória do ano não coincidem.

O que um gráfico circular do Spotify mede de facto

Os gráficos de terceiros leem a tua conta através da Web API do Spotify. Para rankings pessoais só há um endpoint que interessa: o Get User's Top Items, documentado como devolvendo "os artistas ou faixas principais do utilizador atual com base na afinidade calculada". Tudo o que um gráfico de géneros desenha sai dessa resposta, por isso as três limitações do endpoint passam a ser as três limitações do teu gráfico.

O intervalo de tempo é uma escolha da ferramenta

O endpoint aceita um parâmetro time_range com três valores possíveis: "long_term (calculado a partir de cerca de 1 ano de dados e incluindo todos os dados novos à medida que ficam disponíveis), medium_term (aproximadamente os últimos 6 meses), short_term (aproximadamente as últimas 4 semanas)", sendo medium_term o valor por omissão. Um gráfico que parece dizer "o que ando a ouvir agora" está a pedir a janela de quatro semanas. Um que parece mais abrangente está a pedir seis meses ou um ano. Não existe uma opção de sempre nessa lista, e é por isso que nenhum gráfico de géneros honesto pode dizer que cobre toda a tua vida de audições.

Os géneros estão ligados aos artistas, não às músicas

Na resposta, as etiquetas de género vivem no objeto do artista: "Uma lista dos géneros com que o artista está associado. Se ainda não estiver classificado, a lista fica vazia." Não há campo de género no objeto da faixa dentro dessa mesma resposta.

Este detalhe de design explica quase toda a estranheza que as pessoas notam. Um gráfico circular está a contar etiquetas de artistas, não minutos por género. Se três dos teus artistas principais tiverem a mesma etiqueta, essa fatia cresce quer tenhas ouvido uma música de cada quer tenhas ouvido cem. E um artista que o Spotify ainda não classificou não contribui com nada, porque a lista está simplesmente vazia. A página de referência tem agora também uma marca de descontinuação nesse campo de géneros, o que vale a pena saber se estás a decidir quanto investir numa ferramenta baseada em géneros.

A amostra é pequena

O endpoint devolve no máximo 50 itens por pedido. Um gráfico construído a partir de 50 artistas comprime uma longa cauda de audições ocasionais em meia dúzia de fatias gordas. Os géneros em que mergulhas uma vez por mês raramente chegam ao círculo.

Porque é que o teu gráfico muda de semana para semana

Se a ferramenta estiver a usar a janela de cerca de quatro semanas, o gráfico é rolante. Um fim de semana passado com a banda sonora de um filme, um álbum em repeat nos trajetos para o trabalho, e um artista novo empurra outro para fora do top 50. Como as etiquetas de género vêm agarradas a artistas inteiros e não às faixas que ouviste, uma única entrada nova pode arrastar duas ou três etiquetas de uma vez e redesenhar o círculo de forma bem visível.

Também é por isto que dois gráficos gerados com dias de diferença podem parecer de pessoas diferentes. Não está nada avariado. Estás a ver uma janela curta a deslizar para a frente.

Porque é que nunca bate certo com o teu Wrapped

O Wrapped assenta noutras regras, e o Spotify publicou-as. O prazo de corte já bastaria: "o Wrapped capta as tuas audições de 1 de janeiro até meados de novembro". Um gráfico circular gerado em dezembro está a ler uma janela que o Wrapped já tinha fechado.

A lógica de ordenação também é diferente. No Wrapped, os artistas principais são "ordenados por uma contagem ponderada de reproduções", em que os artistas principais pesam mais do que os convidados, enquanto as músicas principais só contam uma audição depois de a faixa tocar mais de 30 segundos. Já um gráfico de géneros está a contar etiquetas em artistas ordenados. Dois métodos razoáveis, duas respostas diferentes.

O Spotify também filtra do lado dele. Faixas que não são música, como ruído branco ou sons da natureza, são excluídas na medida do possível, e as reproduções em Modo Privado ou de músicas e playlists que excluíste do teu Perfil de Gosto não moldam as histórias baseadas no teu gosto. Se alguma vez usaste a opção excluir do teu perfil de gosto numa playlist, o Wrapped respeita isso, e um gráfico de terceiros que lê o endpoint de itens principais não te está a fazer a mesma promessa.

Há ainda uma explicação mais prosaica que o próprio Spotify refere: uma coluna inteligente partilhada ou um sistema de som de casa significa que as audições de um familiar podem ter entrado nos teus resultados. Para perceberes melhor como a personalização alimenta estes números, vê a nossa análise sobre como funcionam as playlists personalizadas do Spotify.

O que mudou na plataforma para programadores do Spotify

É esta a razão pela qual algumas ferramentas funcionam contigo e não com o teu amigo.

Primeira ronda. Num artigo do blogue para programadores intitulado "Introducing some changes to our Web API", de 27 de novembro de 2024, o Spotify anunciou que "os novos casos de uso da Web API deixarão de poder aceder ou utilizar os seguintes endpoints e funcionalidades nas suas aplicações de terceiros". A lista incluía Related Artists, Recommendations, Audio Features, Audio Analysis, Get Featured Playlists e Get Category's Playlists. O ponto decisivo: as aplicações que já tinham acesso em modo estendido e dependiam desses endpoints não foram afetadas. A mudança atingiu as aplicações existentes que continuavam em modo de desenvolvimento sem um pedido de extensão pendente, mais qualquer aplicação registada a partir dessa data.

Essa assimetria é a razão pela qual o ecossistema parece desequilibrado. Uma ferramenta já estabelecida podia continuar a fazer exatamente o que fazia antes, enquanto um clone novo da mesma ideia nem sequer podia ser construído. As ferramentas que visualizavam humor e energia também foram afetadas, porque Audio Features e Audio Analysis estão na lista a que os novos casos de uso já não podem aceder.

Segunda ronda. O guia de migração do Spotify existe "para ajudar os programadores com aplicações existentes a migrar para a Web API atualizada na sequência do anúncio de fevereiro de 2026". O seu calendário marca 11 de fevereiro de 2026 para as novas aplicações em modo de desenvolvimento passarem a ser criadas com as novas restrições, e 9 de março de 2026 para as aplicações já existentes em modo de desenvolvimento serem migradas para elas.

Para projetos pequenos, estas são as restrições que doem:

• Cada aplicação em modo de desenvolvimento exige que o dono tenha uma subscrição Spotify Premium ativa. Se essa subscrição caducar, a aplicação deixa de funcionar, e volta a funcionar quando o dono voltar a subscrever.
• As aplicações novas enfrentam limites de client IDs e de utilizadores por aplicação, com as existentes salvaguardadas: um programador que já tivesse vários client IDs ou mais de cinco utilizadores mantém-nos. Em julho de 2026, o limite de client IDs por programador subiu para 25.
• A pesquisa encolheu. Uma aplicação que precise de mais de 10 resultados por pedido de pesquisa tem agora de paginar com o parâmetro offset.
• As categorias de navegação, os novos lançamentos e as faixas principais do artista foram removidos, e os programadores foram aconselhados a abandonar as funcionalidades que os usavam.
• O conteúdo das playlists só é devolvido para playlists que o utilizador possui ou em que colabora.

Nada disto impede um gráfico de géneros de existir. Mas significa que um gráfico caseiro a correr em modo de desenvolvimento tem um teto de cinco utilizadores, a menos que esteja salvaguardado, e que uma subscrição Premium caducada na conta do programador chega para deitar o site todo abaixo.

O que autorizas quando inicias sessão

O enquadramento do próprio Spotify é que os scopes existem para que "apenas a informação que escolherem partilhar seja partilhada, e nada mais". Um gráfico de géneros precisa do scope apresentado aos utilizadores como "Ler os teus artistas e conteúdos principais", que corresponde à permissão user-top-read. Algumas ferramentas pedem também os dados de reproduções recentes, ou seja, acesso de leitura às faixas ouvidas recentemente.

Lê o ecrã de consentimento em vez do texto de marketing. Se um gráfico pede para gerir as tuas playlists quando tudo o que desenha é um círculo de géneros, essa discrepância é o teu sinal de alerta.

Se a tua ferramenta de géneros deixou de funcionar

Uma triagem rápida, com base no que as mudanças da API fazem de facto:

1. O início de sessão falha ou entra em ciclo. Se a ferramenta corre em modo de desenvolvimento, o acesso está limitado pelo teto de utilizadores por aplicação e depende de o dono manter o Premium ativo. Nada do que mudes na tua conta resolve isso.
2. O gráfico carrega mas faltam fatias. Os artistas que o Spotify ainda não classificou devolvem uma lista de géneros vazia, por isso não acrescentam nada ao gráfico.
3. Desapareceram as leituras de humor, energia ou dançabilidade. Audio Features e Audio Analysis estão entre os endpoints a que os novos casos de uso já não podem aceder.
4. A pesquisa só devolve uns poucos resultados. A pesquisa passou a devolver um máximo menor por pedido, a não ser que a aplicação pagine.
5. Funciona para o teu amigo, mas não para ti. As aplicações com acesso em modo estendido já concedido mantiveram os endpoints antigos, e as aplicações mais antigas ficaram salvaguardadas face aos limites mais recentes.

Como ver os teus géneros principais sem um site de gráficos circulares

Se queres o retrato dos géneros sem apostar na sobrevivência de um projeto caseiro à última migração, o Free Your Music Stats trata disso. A proposta é simples: artistas, músicas e géneros principais, tempo total de audição e uma colagem para partilhar, para Amazon Music, Apple Music, Deezer e Spotify, quando te apetecer. A vista de géneros principais foi feita para mostrar os géneros que definem o teu gosto e os que se têm infiltrado este ano, e o resumo da biblioteca conta quantas playlists, álbuns guardados e músicas curtidas tens mesmo.

Para configurar no Spotify:

1. Descarrega e instala a aplicação Free Your Music no teu dispositivo.
2. Inicia sessão com o login oficial do Spotify. A tua palavra-passe nunca é partilhada.
3. Vai à secção Stats dentro da aplicação.
4. Explora as tuas músicas mais ouvidas, artistas principais, géneros e tendências de audição.

A aplicação lê a tua biblioteca e as tuas reproduções do Spotify através do início de sessão oficial do Spotify e constrói o quadro completo: artistas principais, músicas principais, géneros principais e tempo total de audição. O acesso é só de leitura, o armazenamento é na UE, podes apagar tudo a qualquer momento e nenhuma playlist tua é alterada. As estatísticas são gratuitas no Free Your Music, e não tens de esperar por dezembro para as ver. Há uma página de estatísticas do Spotify dedicada, se só te interessa um serviço.

A cobertura não é igual em todo o lado. Amazon Music, Apple Music, Deezer e Spotify devolvem estatísticas de audição completas, incluindo artistas, músicas, géneros e minutos, enquanto SoundCloud, Tidal, YouTube, Qobuz e Boomplay devolvem estatísticas de biblioteca: playlists, músicas curtidas e álbuns. Quando um serviço não reporta tempos de reprodução, essas secções ficam assinaladas em vez de adivinhadas.

Para o leque mais alargado de opções, incluindo o que cada método consegue e não consegue dizer-te, lê o nosso guia sobre como ver as tuas estatísticas do Spotify, ou o apanhado do que serve de alternativa ao Spotify Wrapped fora de dezembro.

FAQ

Posso ter um gráfico circular dos meus géneros de sempre?

A partir do endpoint de itens principais, não. A janela mais larga que oferece é calculada a partir de cerca de um ano de dados, por isso qualquer ferramenta que diga fazer um gráfico de géneros de uma vida inteira com ele está a esticar a verdade. Trata o gráfico como um retrato das audições recentes.

Porque é que as minhas etiquetas de género são tão estranhamente específicas?

Porque são as etiquetas do artista, copiadas tal e qual. A API devolve uma lista dos géneros com que um artista está associado, e a lista fica vazia para os artistas ainda não classificados. O gráfico não está a inventar categorias para ti; está a contar etiquetas de outra pessoa.

Um gráfico de géneros bate certo com o Wrapped se o gerar em novembro?

Continua a não bater. O Wrapped vai de 1 de janeiro a meados de novembro e ordena os artistas por contagem ponderada de reproduções, enquanto um gráfico conta etiquetas de género nos teus artistas principais numa janela de quatro semanas, seis meses ou um ano. Janelas diferentes e contas diferentes dão listas diferentes.

Posso ver géneros em serviços que não sejam o Spotify?

Sim, em alguns. Amazon Music, Apple Music, Deezer e Spotify dão estatísticas de audição completas, incluindo géneros; SoundCloud, Tidal, YouTube, Qobuz e Boomplay dão estatísticas de biblioteca em vez disso.