PERGUNTAS COMUNS
Perguntas Frequentes
A LabelGrid tem uma API pública?
Sim. A LabelGrid oferece uma API REST pública, documentada abertamente em https://api.labelgrid.com/docs/api. Você pode ler cada endpoint, requisição e resposta sem login e sem contato com vendas. O cadastro é self-service: a documentação é aberta, sem login e sem contato com vendas, e as chamadas à API rodam em um plano de API que você escolhe a partir dos preços publicados.
Existe um sandbox?
Sim. O sandbox vem em todos os níveis de API e é ativado junto com o seu plano, então você desenvolve e testa em endpoints reais sem afetar entregas ao vivo nem dinheiro real. Ele faz parte do plano, não é um teste por tempo limitado. A documentação é pública, então você avalia toda a superfície da API antes de pagar qualquer coisa.
Como faço para entregar via DDEX?
A LabelGrid fala DDEX nos dois sentidos e gera feeds ERN em conformidade para cada DSP quando você envia um lançamento para distribuição. Isso cobre a linha atual 4.3 (4.3.0, 4.3.1 e 4.3.2) e a legada 3.8.2, com suporte completo a NewReleaseMessage e PurgeReleaseMessage, e cada DSP recebe a versão que exige: você nunca gerencia versões. Se você está migrando um catálogo, a importação DDEX traz o seu feed atual durante o onboarding. Veja o guia de importação DDEX na Central de Ajuda para saber o que aceitamos.
Como sou notificado quando uma entrega acontece?
Registre um webhook pela API e a LabelGrid envia eventos para você assim que acontecem, incluindo mudanças de status de revisão e atualizações de entrega, em vez de você ficar consultando o estado repetidamente. Você pode escolher quais tipos de evento cada endpoint recebe, enviar hooks de teste, inspecionar logs de entrega e rotacionar o segredo de assinatura. Os payloads são assinados para que você possa verificar que vieram da LabelGrid.
Para onde a API entrega?
Para todos os lugares em que a LabelGrid entrega. A mesma rede está disponível pela API e pelo aplicativo: todos os principais DSPs, incluindo Spotify, Apple Music, Amazon Music, Deezer, TIDAL e YouTube Music, além de plataformas sociais e de UGC como TikTok e Instagram, e plataformas regionais em todos os continentes. Não existe um nível reduzido de entrega pela API — um lançamento enviado por REST chega aos mesmos destinos que um enviado pelo painel, na versão DDEX ERN que cada plataforma exige.
Quais são os limites dos planos na API?
Eles são publicados, não negociados. O Starter API cobre até 3,000 faixas e 5 gravadoras, com até $35k em processamento mensal de royalties; o Growth API, até 10,000 faixas e 25 gravadoras, com até $115k; o Scale API, até 25,000 faixas e 100 gravadoras, com até $350k. Assentos extras de gravadora são adicionais em cada nível, e o Custom API aceita limites de faixas sob medida com gravadoras ilimitadas. Os planos de API têm cobrança anual, exceto excedentes. Acesso completo à API e sandbox estão em todos os níveis — o sandbox não é medido como um teste. A tabela completa está na página de preços.
Que suporte os clientes de API recebem?
Um SLA de suporte em todo plano de API. Starter e Growth têm resposta do suporte em até dois dias úteis, e Scale e Custom acrescentam um gerente de conta técnico dedicado, com SLAs personalizados disponíveis no nível enterprise. São metas, não garantias por chamado, e na prática o tempo médio até a primeira resposta fica abaixo de duas horas em horário comercial. O suporte é 100% humano, sem chatbots, e funciona em dias úteis, no horário comercial, não 24 horas por dia. Você fala com a equipe que roda a plataforma, e a documentação, o sandbox e os preços são abertos, então a maior parte do desenvolvimento nunca precisa de conversa nenhuma.