Upload em massa e migração de catálogos grandes

Atualizado em julho de 2026.

Para migrar ou fazer o upload de um catálogo grande, use as ferramentas de upload em massa da LabelGrid: integração por API para fluxos automatizados e personalizados, ou importação DDEX para feeds no padrão do setor e migrações em escala de distribuidora. Ambas estão disponíveis em planos com acesso à API ativado. Reutilize seus ISRCs e UPCs existentes com metadados iguais para preservar streams e playlists. Este guia cobre os dois métodos e como mover com segurança um catálogo em escala de distribuidora.

Para a migração passo a passo de outro distribuidor em qualquer escala, veja Transferir seu catálogo.

Métodos de upload em massa

Opções disponíveis

Método	Melhor para	Plano necessário
Integração por API	Fluxos automatizados, integrações personalizadas	Planos com acesso à API ativado
Importação DDEX	Feeds no padrão do setor, fluxos de grandes gravadoras	Planos Enterprise / API (fale com o suporte)

Nota

Os métodos de upload em massa estão disponíveis em planos com acesso à API ativado. Se o seu plano não inclui acesso à API, você pode criar lançamentos individualmente pelo painel da LabelGrid ou falar com o suporte para discutir a ativação do acesso à API.

---

Integração por API

Visão geral

A API da LabelGrid permite criar e gerenciar lançamentos de forma programática, viabilizando fluxos totalmente automatizados para catálogos grandes.

O que você pode fazer

• Criar lançamentos de forma programática
• Enviar arquivos de áudio via API
• Gerenciar metadados em massa
• Automatizar fluxos de distribuição
• Integrar com seus sistemas existentes

Como começar

1. Ative o acesso à API no seu plano — fale com o suporte se ainda não estiver ativado
2. Gere as credenciais de API nas configurações da sua conta
3. Consulte a documentação da API para os detalhes dos endpoints
4. Implemente sua integração ou use nossos SDKs
5. Teste no ambiente de staging antes de ir para produção

Exemplo de requisição

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

Como registrar seu distribuidor anterior

Quando você está migrando lançamentos que já estão no ar em outro lugar, a Releases API pública aceita um campo opcional transfer_from_distributor (texto livre, até 255 caracteres) para registrar o distribuidor de onde você está saindo. Ele fica somente leitura assim que o lançamento é distribuído, então defina-o antes ou no momento do envio.

Vantagens da API

• Automação total - Sem intervenção manual
• Integração de sistemas - Conecte com seu DAM, CRM ou outras ferramentas
• Lançamentos agendados - Enfileire lançamentos para distribuição futura
• Validação personalizada - Valide o conteúdo antes do envio
• Notificações via webhook - Receba atualizações em tempo real sobre o status de entrega
• Tratamento de erros - Detecção e nova tentativa de erros de forma programática

Limites de taxa

A API tem limites de taxa para garantir a estabilidade do sistema. Consulte a Visão geral da API para os detalhes atuais dos limites de taxa.

Consulte a Visão geral da API para a documentação completa.

---

Importação DDEX

Visão geral

O DDEX (Digital Data Exchange) é o formato padrão do setor usado pelas grandes gravadoras para entregar conteúdo aos distribuidores. A LabelGrid oferece importação DDEX para clientes enterprise que já têm infraestrutura de entrega DDEX.

O que é DDEX?

O DDEX é um padrão baseado em XML que empacota:

• Metadados do lançamento
• Informações das faixas
• Referências aos arquivos de áudio
• Capa e outros ativos
• Termos de acordo e territórios

Formatos aceitos

Versão	Status
ERN 4.3.2	Aceito (recomendado)
ERN 4.3.1	Aceito
ERN 4.3.0	Aceito
ERN 3.8.2	Aceito (legado)

Processo de configuração do DDEX

1. Fale com o suporte para solicitar a ativação do DDEX
2. Faça o onboarding com nossa equipe técnica
3. Configure as opções de entrega e os caminhos de arquivo
4. Configure as credenciais SFTP para a transferência segura de arquivos
5. Envie uma entrega de teste para validação
6. Inicie as entregas de produção após a aprovação

Fluxo de entrega

Seu sistema → XML DDEX + Ativos → Upload por SFTP → Processamento na LabelGrid → Distribuição

Requisitos do DDEX

Requisito	Detalhes
Plano	Acesso à API ativado (fale com o suporte)
Formato	ERN 4.3.2 preferencial (4.3.1, 4.3.0 e 3.8.2 também aceitos)
Entrega	Somente SFTP
Ativos	Arquivos de áudio incluídos ou referenciados
Validação	Validação prévia recomendada

Quando usar o DDEX

A importação DDEX é ideal se:

• Você já tem infraestrutura de entrega DDEX
• Você está migrando de outro distribuidor que usa DDEX
• Seu sistema de gestão de conteúdo exporta DDEX nativamente
• Você é uma grande gravadora ou um independente de grande porte com fluxos consolidados

Quando usar a API

A API REST/JSON é melhor se:

• Você está construindo uma nova integração do zero
• Você prefere APIs web modernas em vez de XML
• Você precisa de comunicação bidirecional em tempo real
• Você quer notificações baseadas em webhook

---

Como escolher o método

Fator	Integração por API	Importação DDEX
Complexidade de configuração	Menor	Maior
Infraestrutura existente	Construir do zero	Usar o DDEX existente
Formato	JSON	XML
Método de entrega	HTTPS	SFTP
Atualizações em tempo real	Sim (webhooks)	Requer polling
Melhor para	Novas integrações	Migração enterprise

---

Tempos de processamento

Depois que o conteúdo é enviado via API ou DDEX, o tempo de processamento depende de:

• Número de lançamentos e faixas
• Tamanho dos arquivos de áudio
• Complexidade dos metadados
• Carga atual do sistema

Catálogos maiores naturalmente levam mais tempo para processar. Fale com o suporte se precisar de orientação sobre os prazos esperados para o tamanho específico do seu catálogo.

---

Limites de envio para migrações grandes

Migrações grandes podem esbarrar em um limite de envio contínuo que conta as importações por API e DDEX também — veja Limites de catálogo e lançamentos para entender como funciona. Antes de uma migração única de grande porte, fale com o suporte para combinarmos uma janela temporária de isenção, em vez de você esbarrar no limite no meio da migração.

Confira se todas as faixas foram importadas

Depois de um upload em massa ou uma importação DDEX, confirme se todas as faixas foram importadas corretamente antes de distribuir.

---

Perguntas frequentes

”Como migro um catálogo grande para a LabelGrid?”

Use o upload em massa — integração por API (para fluxos automatizados e personalizados) ou importação DDEX (para feeds no padrão do setor e migrações em escala de distribuidora). Ambos exigem acesso à API ativado no seu plano. Reutilize seus ISRCs e UPCs existentes com metadados exatamente iguais para que os DSPs preservem seus streams, saves e playlists, e faça o upload para a LabelGrid antes de tirar seu catálogo do antigo distribuidor.

”A LabelGrid consegue importar meu catálogo via DDEX?”

Sim. A LabelGrid oferece importação DDEX (ERN 4.3.2 recomendado; 4.3.1, 4.3.0 e 3.8.2 também são aceitos) via SFTP para clientes que já têm infraestrutura de entrega DDEX. Fale com o suporte para ativá-la. A LabelGrid é compatível com o padrão DDEX, mas não é membro do consórcio DDEX.

”Quais versões do DDEX ERN a LabelGrid aceita?”

A LabelGrid aceita DDEX ERN 3.8.2, 4.3.0, 4.3.1 e 4.3.2, sendo a 4.3.2 recomendada para novas entregas. A LabelGrid é compatível com esses padrões e não é membro do consórcio DDEX.

”Meus streams e playlists são mantidos quando migro um catálogo grande?”

Sim, desde que você reutilize os mesmos ISRCs e UPCs com metadados exatamente iguais. Os DSPs relacionam o conteúdo por ISRC e UPC, então códigos e metadados idênticos permitem que eles unam seu catálogo aos lançamentos existentes e mantenham seu histórico de streaming, saves e posições em playlists.

”Quais são os limites de envio para uma migração única de grande porte?”

Migrações grandes contam para um limite de envio contínuo que inclui as importações por API e DDEX. Antes de uma migração grande, fale com o suporte para combinar uma janela temporária de isenção e não esbarrar no limite no meio da migração.

---

Relacionados

Gerenciando um catálogo grande? Veja gestão de catálogo no nosso site para entender como a LabelGrid mantém seus lançamentos organizados em escala. Veja também Transferir seu catálogo.

---

Precisa de ajuda?

Para ajuda com a configuração do upload em massa:

• Integração por API: veja a Visão geral da API ou fale com o suporte
• Ativação do DDEX: fale com nossa equipe de suporte com os seus requisitos

Nossa equipe pode ajudar você a escolher o método certo e orientar durante a configuração.