API e MCP
Nesta seção3 artigos

Acesso à API no plano Label

O plano Label permite chamar a API do Music24 com seus próprios tokens. Você gerencia os tokens em Configurações → API. O MCP funciona em todos os planos.

Verificado em 8 de out. de 2026

A API do Music24 dá a você os mesmos dados de paradas, playlists e acompanhamento que o app usa, para você criar seus próprios painéis e automações. O acesso à API faz parte do plano Label ($249 por mês, USD). Em todos os outros planos, Configurações → API mostra um banner de upgrade no lugar dos seus tokens.

Onde encontrar

Abra Configurações → API no app web, ou Configurações → API no app para iPhone ou Android. A página Acesso à API lista seus tokens e, na web, um Início rápido com uma requisição de exemplo.

Como os tokens funcionam

  • Um token pessoal começa com m24_. Nós o mostramos uma vez, quando você o cria, e depois guardamos só os primeiros caracteres.
  • Você pode ter 5 tokens ativos. Revogue um para abrir espaço para outro.
  • Um token pertence ao espaço de trabalho que estava ativo quando você o criou e lê os dados desse espaço. Se você sair do espaço de trabalho, se o proprietário remover você ou se você excluir sua conta, os tokens dele param de funcionar.
  • Todo membro de um espaço de trabalho Label pode criar seus próprios tokens, não só o proprietário.
  • Os tokens não expiram. Um token funciona até você revogá-lo.
  • Um token age como você no espaço de trabalho dele. Ele lê dados e também pode fazer a maioria das mudanças que você faz no app. Se você é proprietário do espaço de trabalho, ele também pode abrir a cobrança. Ele não pode mudar seu e-mail, convidar ou remover pessoas, trocar ou renomear espaços de trabalho, gerenciar tokens nem excluir a conta. Guarde-o em segredo, como uma senha.

Faça uma requisição

Envie o token no cabeçalho Authorization como Token m24_…. O URL base é https://api.music24.com/trpc. Um GET lê dados. Copie a requisição de exemplo em Início rápido, em Configurações → API, para fazer sua primeira chamada, e leia a documentação completa da API.

Limites

Cada pessoa pode fazer 30 requisições por minuto a um endpoint. O limite conta por usuário, então mais tokens não dão mais requisições. Acima do limite, a API responde TOO_MANY_REQUESTS. Espere um minuto e tente de novo.

A API segue os mesmos limites de plano do app, como 365 dias de histórico no Label.

Precisa de limites maiores, endpoints personalizados ou um acordo de licenciamento? Escreva para [email protected].

Se o espaço de trabalho sair do plano Label, seus tokens ficam, mas toda requisição é recusada com “O acesso à API exige o plano Label do Music24.” Eles voltam a funcionar quando o espaço de trabalho volta ao Label.

Próximos passos: criar e revogar um token ou usar o Music24 em um cliente de IA (MCP).

Perguntas

Qual plano inclui a API do Music24?

O plano Label. Ele inclui os tokens de API. Nenhum outro plano, nem o teste, inclui. O MCP funciona em todos os planos e apenas lê seus dados.

Qual é o limite de requisições da API?

30 requisições por minuto por usuário em cada endpoint. Escreva para [email protected] se precisar de mais.

Artigos relacionados

Still need help?

A person reads every message and replies to the address you write from.