Massen-Upload und Migration großer Kataloge

Aktualisiert im Juli 2026.

Um einen großen Katalog zu migrieren oder hochzuladen, nutzen Sie die Massen-Tools von LabelGrid: die API-Integration für automatisierte, individuelle Abläufe oder den DDEX-Import für branchenübliche Feeds und Migrationen in Vertriebsgröße. Beide sind in Tarifen mit freigeschaltetem API-Zugang verfügbar. Verwenden Sie Ihre bestehenden ISRCs und UPCs mit übereinstimmenden Metadaten erneut, damit Streams und Playlists erhalten bleiben. Dieser Leitfaden behandelt beide Methoden und zeigt, wie Sie einen Katalog in Vertriebsgröße sicher verschieben.

Eine Schritt-für-Schritt-Migration von einem anderen Vertrieb in beliebigem Umfang finden Sie unter Katalog übertragen.

Methoden für den Massen-Upload

Verfügbare Optionen

Methode	Am besten geeignet für	Erforderlicher Tarif
API-Integration	Automatisierte Abläufe, individuelle Integrationen	Tarife mit freigeschaltetem API-Zugang
DDEX-Import	Branchenübliche Feeds, Abläufe großer Labels	Enterprise-/API-Tarife (Support kontaktieren)

Hinweis

Die Methoden für den Massen-Upload sind in Tarifen mit freigeschaltetem API-Zugang verfügbar. Enthält Ihr Tarif keinen API-Zugang, können Sie Releases einzeln über das LabelGrid-Dashboard anlegen oder den Support kontaktieren, um die Freischaltung des API-Zugangs zu besprechen.

---

API-Integration

Überblick

Über die LabelGrid-API können Sie Releases programmatisch anlegen und verwalten und so vollständig automatisierte Abläufe für große Kataloge umsetzen.

Ihre Möglichkeiten

• Releases programmatisch anlegen
• Audiodateien per API hochladen
• Metadaten in großen Mengen verwalten
• Vertriebsabläufe automatisieren
• In Ihre bestehenden Systeme integrieren

Erste Schritte

1. API-Zugang im Tarif freischalten – kontaktieren Sie den Support, falls er noch nicht aktiviert ist
2. API-Zugangsdaten erstellen in Ihren Kontoeinstellungen
3. API-Dokumentation prüfen für Details zu den Endpunkten
4. Ihre Integration umsetzen oder unsere SDKs verwenden
5. In der Staging-Umgebung testen vor dem Produktivbetrieb

Beispiel-Anfrage

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"
    }
  ]
}

Ihren bisherigen Vertrieb festhalten

Wenn Sie Releases migrieren, die anderswo bereits live sind, akzeptiert die öffentliche Releases-API ein optionales Feld transfer_from_distributor (Freitext, bis zu 255 Zeichen), um den Vertrieb festzuhalten, von dem Sie wechseln. Es wird schreibgeschützt, sobald das Release verteilt ist – setzen Sie es also vor oder bei der Einreichung.

Vorteile der API

• Vollständige Automatisierung – kein manuelles Eingreifen erforderlich
• Systemintegration – Verbindung mit Ihrem DAM, CRM oder anderen Werkzeugen
• Geplante Releases – Releases für den späteren Vertrieb in die Warteschlange stellen
• Individuelle Validierung – Inhalte vor der Einreichung vorab prüfen
• Webhook-Benachrichtigungen – Echtzeit-Updates zum Lieferstatus erhalten
• Fehlerbehandlung – programmatische Fehlererkennung und erneute Versuche

Rate-Limits

Die API hat Rate-Limits, um die Systemstabilität sicherzustellen. Aktuelle Details zu den Rate-Limits finden Sie in der API-Übersicht.

Die vollständige Dokumentation finden Sie in der API-Übersicht.

---

DDEX-Import

Überblick

DDEX (Digital Data Exchange) ist das branchenübliche Format, mit dem große Labels Inhalte an Vertriebe liefern. LabelGrid unterstützt den DDEX-Import für Enterprise-Kunden, die bereits über eine DDEX-Lieferinfrastruktur verfügen.

Was ist DDEX?

DDEX ist ein XML-basierter Standard, der Folgendes bündelt:

• Release-Metadaten
• Track-Informationen
• Verweise auf Audiodateien
• Artwork und Assets
• Vertragsbedingungen und Territorien

Unterstützte Formate

Version	Status
ERN 4.3.2	Unterstützt (empfohlen)
ERN 4.3.1	Unterstützt
ERN 4.3.0	Unterstützt
ERN 3.8.2	Unterstützt (Legacy)

DDEX-Einrichtungsprozess

1. Support kontaktieren, um die DDEX-Freischaltung anzufordern
2. Onboarding durchlaufen mit unserem technischen Team
3. Liefereinstellungen und Dateipfade konfigurieren
4. SFTP-Zugangsdaten einrichten für die sichere Dateiübertragung
5. Testlieferung einreichen zur Validierung
6. Produktivlieferungen starten, sobald sie freigegeben sind

Lieferablauf

Ihr System → DDEX-XML + Assets → SFTP-Upload → LabelGrid-Verarbeitung → Vertrieb

DDEX-Anforderungen

Anforderung	Details
Tarif	API-Zugang freigeschaltet (Support kontaktieren)
Format	ERN 4.3.2 bevorzugt (4.3.1, 4.3.0 und 3.8.2 ebenfalls unterstützt)
Lieferung	Nur SFTP
Assets	Audiodateien enthalten oder referenziert
Validierung	Vorabprüfung empfohlen

Wann DDEX sinnvoll ist

Der DDEX-Import eignet sich, wenn:

• Sie bereits über eine DDEX-Lieferinfrastruktur verfügen
• Sie von einem anderen Vertrieb wechseln, der DDEX nutzt
• Ihr Content-Management-System DDEX nativ exportiert
• Sie ein großes Label oder ein großer Independent mit etablierten Abläufen sind

Wann stattdessen die API sinnvoll ist

Die REST/JSON-API ist die bessere Wahl, wenn:

• Sie eine neue Integration von Grund auf aufbauen
• Sie moderne Web-APIs gegenüber XML bevorzugen
• Sie bidirektionale Kommunikation in Echtzeit benötigen
• Sie Webhook-basierte Benachrichtigungen möchten

---

Die richtige Methode wählen

Faktor	API-Integration	DDEX-Import
Einrichtungsaufwand	Geringer	Höher
Vorhandene Infrastruktur	Neu aufbauen	Vorhandenes DDEX nutzen
Format	JSON	XML
Liefermethode	HTTPS	SFTP
Echtzeit-Updates	Ja (Webhooks)	Abfrage erforderlich
Am besten für	Neue Integrationen	Enterprise-Migration

---

Verarbeitungszeiten

Sobald Inhalte per API oder DDEX hochgeladen sind, hängt die Verarbeitungszeit ab von:

• Anzahl der Releases und Tracks
• Größe der Audiodateien
• Komplexität der Metadaten
• Aktueller Systemauslastung

Größere Kataloge brauchen naturgemäß länger. Kontaktieren Sie den Support, wenn Sie eine Einschätzung zu den erwarteten Zeiten für Ihre konkrete Kataloggröße benötigen.

---

Einreichungslimits bei großen Migrationen

Große Migrationen können an ein rollierendes Einreichungslimit stoßen, das auch API- und DDEX-Importe mitzählt – wie es funktioniert, lesen Sie unter Katalog- und Release-Limits. Wenden Sie sich vor einer großen einmaligen Migration an den Support, damit wir ein befristetes Ausnahmefenster einrichten können und Sie nicht mitten in der Migration an das Limit stoßen.

Prüfen Sie, ob alle Tracks eingelesen wurden

Bestätigen Sie nach einem Massen- oder DDEX-Import, dass jeder Track korrekt importiert wurde, bevor Sie mit dem Vertrieb beginnen.

---

FAQ

„Wie migriere ich einen großen Katalog zu LabelGrid?”

Nutzen Sie den Massen-Upload – entweder die API-Integration (für automatisierte, individuelle Abläufe) oder den DDEX-Import (für branchenübliche Feeds und Migrationen in Vertriebsgröße). Beide setzen einen freigeschalteten API-Zugang in Ihrem Tarif voraus. Verwenden Sie Ihre bestehenden ISRCs und UPCs mit exakt übereinstimmenden Metadaten erneut, damit die DSPs Ihre Streams, Saves und Playlists erhalten, und laden Sie zuerst zu LabelGrid hoch, bevor Sie Ihren Katalog beim alten Vertrieb offline nehmen.

„Kann LabelGrid meinen Katalog per DDEX importieren?”

Ja. LabelGrid unterstützt den DDEX-Import (ERN 4.3.2 empfohlen; 4.3.1, 4.3.0 und 3.8.2 werden ebenfalls unterstützt) über SFTP für Kunden mit vorhandener DDEX-Lieferinfrastruktur. Wenden Sie sich an den Support, um ihn zu aktivieren. LabelGrid unterstützt den DDEX-Standard, ist aber kein Mitglied des DDEX-Konsortiums.

„Welche DDEX-ERN-Versionen unterstützt LabelGrid?”

LabelGrid unterstützt DDEX ERN 3.8.2, 4.3.0, 4.3.1 und 4.3.2, wobei 4.3.2 für neue Lieferungen empfohlen wird. LabelGrid unterstützt diese Standards und ist kein Mitglied des DDEX-Konsortiums.

„Bleiben meine Streams und Playlists bei der Migration eines großen Katalogs erhalten?”

Ja, sofern Sie dieselben ISRCs und UPCs mit exakt übereinstimmenden Metadaten erneut verwenden. DSPs ordnen Inhalte anhand von ISRC und UPC zu, sodass identische Codes und Metadaten dafür sorgen, dass Ihr Katalog mit den vorhandenen Releases zusammengeführt wird und Ihr Streaming-Verlauf, Ihre Saves und Playlist-Platzierungen erhalten bleiben.

„Welche Einreichungslimits gelten bei einer großen einmaligen Migration?”

Große Migrationen zählen zu einem rollierenden Einreichungslimit, das auch API- und DDEX-Importe umfasst. Wenden Sie sich vor einer großen Migration an den Support, um ein befristetes Ausnahmefenster einzurichten, damit Sie nicht mitten in der Migration an das Limit stoßen.

---

Verwandte Themen

Verwalten Sie einen großen Katalog? Unter Katalogverwaltung auf unserer Website erfahren Sie, wie LabelGrid Ihre Releases auch bei großem Umfang organisiert. Siehe auch Katalog übertragen.

---

Brauchen Sie Hilfe?

Unterstützung bei der Einrichtung des Massen-Uploads:

• API-Integration: Siehe API-Übersicht oder kontaktieren Sie den Support
• DDEX-Freischaltung: Kontaktieren Sie unser Support-Team mit Ihren Anforderungen

Unser Team hilft Ihnen, die richtige Methode zu wählen, und begleitet Sie durch die Einrichtung.