Visão geral da API e guia rápido

Atualizado em julho de 2026.

Sim, o LabelGrid oferece uma API REST pública para distribuição programática. Ela permite que desenvolvedores leiam seu catálogo, criem e atualizem lançamentos, enviem assets e submetam lançamentos para distribuição, e é o que sustenta os serviços white-label criados sobre o LabelGrid. Este guia é a introdução rápida; a referência completa de endpoints está em api.labelgrid.com/docs/api.

O guia rápido em resumo

Etapa	O que você faz
1. Ativar um plano de API	O acesso à API e ao sandbox exige um plano de API ativo e pago (cobrado anualmente).
2. Gerar um token de API	Abra o menu do avatar (canto superior direito) e clique em API Tokens para criar um Bearer token.
3. (Opcional) Configurar a whitelist de IP	Restrinja o uso do token a IPs conhecidos na mesma área de API Tokens.
4. Ler a referência	Explore os endpoints e o recurso “try it” em api.labelgrid.com/docs/api.
5. Desenvolver no sandbox	Peça um sandbox ao suporte e teste sem tocar em produção.
6. Ir para produção	Aponte a sua integração para `api.labelgrid.com` e crie o seu primeiro lançamento.

O que a API oferece

A API pública é montada sob /api/public/... em api.labelgrid.com e oferece acesso programático a:

Lançamentos — listar, criar, atualizar, excluir; enviar capa; validar; submeter para distribuição
Faixas — listar, criar, atualizar; enviar arquivos de áudio; gerenciar licenças de faixas
Gravadoras — listar e gerenciar seus perfis de gravadora
Artistas — listar e gerenciar perfis de artistas
Compositores e colaboradores — listar e gerenciar perfis de compositores/colaboradores
Editoras — listar e gerenciar perfis de editoras
Webhooks — registrar endpoints de webhook para notificações assíncronas
Dados de referência — gêneros, idiomas, funções de colaboradores, instrumentos, territórios de distribuição, outlets de distribuição

Casos de uso comuns

Automatizar a criação de lançamentos a partir dos seus sistemas existentes
Sincronizar dados de catálogo com seu banco de dados
Criar painéis e ferramentas de relatório personalizados
Integrar com suas ferramentas de fluxo de trabalho existentes
Sustentar serviços de distribuição white-label em cima do LabelGrid

Obtendo acesso à API

Para usar a API do LabelGrid, você precisa de:

Um plano de API ativo e pago — o acesso à API e ao sandbox exige um plano de API pago. O período de teste gratuito de 7 dias que acompanha os planos padrão não inclui acesso à API nem ao sandbox, e os planos de API são cobrados imediatamente (sem período de teste).
Um token de API gerado nas configurações da sua conta: abra o menu do avatar no canto superior direito e clique em API Tokens (visível somente se o acesso à API estiver habilitado)
(Opcional) Whitelist de IP para segurança adicional — configure na mesma área

Se você não vir a opção API Tokens na sua conta, fale com o suporte para discutir a habilitação do acesso à API no seu plano.

Autenticação

Toda requisição à API precisa incluir um Bearer token no cabeçalho Authorization:

Authorization: Bearer YOUR_API_TOKEN

Documentação da API

Para a referência completa de endpoints, os schemas de requisição/resposta e o recurso “try it” ao vivo, veja a documentação gerada automaticamente:

Produção: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

A documentação inclui:

Guia de autenticação
Cada endpoint disponível, com exemplos de requisição e resposta
Informações sobre limites de taxa (rate limiting)
Configuração de webhooks

Sandbox

O LabelGrid oferece um ambiente de sandbox para você desenvolver e testar com a API sem afetar seu catálogo de produção. O acesso ao sandbox exige um plano de API ativo e é provisionado por nós mediante solicitação — assim que seu plano de API estiver ativo, fale com o suporte para configurá-lo. Configuramos a whitelist de IP do sandbox para você; a whitelist de IP de produção é autosserviço em API Tokens.

Webhooks

A API pública oferece suporte a webhooks para notificação assíncrona de eventos (mudanças no status da análise, atualizações de entrega etc.). Veja Webhooks para configuração e os tipos de evento disponíveis.

Perguntas frequentes

”O LabelGrid tem uma API pública?”

Sim. O LabelGrid oferece uma API REST pública para distribuição programática, disponível em /api/public/... no domínio api.labelgrid.com. Você pode ler seu catálogo, criar e atualizar lançamentos, enviar áudio e capas, gerenciar artistas e colaboradores, registrar webhooks e submeter lançamentos para distribuição. A documentação completa está em api.labelgrid.com/docs/api.

”Como obtenho acesso à API?”

O acesso à API e ao sandbox exige um plano de API ativo e pago. Com o plano de API ativo, gere um token de API nas configurações da sua conta, em API Tokens (no menu do avatar, no canto superior direito). Se você não vir essa opção, fale com o suporte para habilitar o acesso à API. O período de teste gratuito de 7 dias dos planos padrão não inclui acesso à API.

”Como autentico as requisições à API?”

Inclua um Bearer token no cabeçalho Authorization de toda requisição: Authorization: Bearer YOUR_API_TOKEN. Gere o token em API Tokens, nas configurações da sua conta, e, se quiser, restrinja o uso por whitelist de IP.

”Existe um ambiente de sandbox para testes?”

Sim. O LabelGrid oferece um sandbox para você desenvolver e testar com a API sem afetar seu catálogo de produção. O acesso ao sandbox exige um plano de API ativo e é provisionado mediante solicitação: fale com o suporte assim que o seu plano de API estiver ativo. A documentação do sandbox está em api-sandbox.stg.labelgrid.com/docs/api.

”Quanto custa a API do LabelGrid?”

A API está disponível nos planos de API do LabelGrid, cobrados anualmente. Os planos começam no nível Starter API, com níveis superiores para catálogos maiores e limites mais altos de processamento de royalties. Consulte a página de preços para ver os valores atuais e os detalhes de cada nível.

Relacionados

Construindo sobre a API do LabelGrid? Veja o hub para desenvolvedores para uma visão geral do que é possível. Se você está sustentando um serviço de distribuição white-label em cima do LabelGrid, a página infraestrutura para distribuidores cobre o panorama mais amplo. Veja também o guia Configuração de distribuição white-label.

Precisa de ajuda?

Se você precisar de assistência com a API, fale com nossa equipe de suporte com detalhes técnicos sobre sua integração.

Ainda não usa a LabelGrid?

Tudo o que você acabou de ler está disponível na nossa plataforma.

Veja o que a LabelGrid pode fazer →