API-Überblick und Schnellstart

Aktualisiert im Juli 2026.

Ja — LabelGrid bietet eine öffentliche REST-API für den programmatischen Vertrieb. Sie ermöglicht Entwicklern, Ihren Katalog zu lesen, Releases zu erstellen und zu aktualisieren, Assets hochzuladen und Releases zum Vertrieb einzureichen, und sie treibt White-Label-Dienste an, die auf LabelGrid aufbauen. Dieser Leitfaden ist der Schnellstart; die vollständige Endpunktreferenz finden Sie unter api.labelgrid.com/docs/api.

Der Schnellstart auf einen Blick

Schritt	Was Sie tun
1. Einen API-Tarif aktivieren	API- und Sandbox-Zugang erfordern einen aktiven, kostenpflichtigen API-Tarif (jährliche Abrechnung).
2. Ein API-Token generieren	Öffnen Sie das Avatar-Menü (oben rechts) und klicken Sie auf API-Tokens, um ein Bearer-Token zu erstellen.
3. (Optional) IP-Whitelisting	Beschränken Sie die Token-Nutzung im selben Bereich API-Tokens auf bekannte IPs.
4. Die Referenz lesen	Erkunden Sie Endpunkte und „Try it“-Tooling unter api.labelgrid.com/docs/api.
5. Gegen die Sandbox entwickeln	Fordern Sie eine Sandbox beim Support an und testen Sie, ohne die Produktion zu berühren.
6. In die Produktion gehen	Richten Sie Ihre Integration auf api.labelgrid.com aus und erstellen Sie Ihr erstes Release.

Lieber natürliche Sprache statt rohem REST?

LabelGrid veröffentlicht auch einen offiziellen MCP-Server, der KI-Clients wie Claude Desktop, Claude Code und Cursor mit dieser API verbindet. Sie beschreiben in natürlicher Sprache, was Sie möchten — ein Release anlegen, es validieren, Analysen abrufen — und Ihr KI-Assistent übernimmt die API-Aufrufe. Siehe Ihren KI-Assistenten mit LabelGrid verbinden (MCP).

Was die API bietet

Die öffentliche API ist unter /api/public/... auf api.labelgrid.com eingebunden und bietet programmatischen Zugriff auf:

• Releases – auflisten, erstellen, aktualisieren, löschen; Artwork hochladen; validieren; zum Vertrieb einreichen
• Tracks – auflisten, erstellen, aktualisieren; Audiodateien hochladen; Track-Lizenzen verwalten
• Labels – Ihre Label-Profile auflisten und verwalten
• Künstler – Künstlerprofile auflisten und verwalten
• Autoren und Mitwirkende – Autoren-/Mitwirkenden-Profile auflisten und verwalten
• Verlage – Verlagsprofile auflisten und verwalten
• Webhooks – Webhook-Endpunkte für asynchrone Benachrichtigungen registrieren
• Analytics – Streaming-, Hörer- und Engagement-Daten nach Tag, Plattform, Land und Track; siehe Umfangsfilter und Daten pro Track und Plattformen, Verfügbarkeit und Limits
• Referenzdaten – Genres, Sprachen, Mitwirkendenrollen, Instrumente, Vertriebsterritorien, Vertriebs-Outlets

Häufige Anwendungsfälle

• Die Release-Erstellung aus Ihren bestehenden Systemen automatisieren
• Katalogdaten mit Ihrer Datenbank synchronisieren
• Eigene Dashboards und Reporting-Tools erstellen
• Mit Ihren bestehenden Workflow-Tools integrieren
• White-Label-Vertriebsdienste auf Basis von LabelGrid betreiben

---

API-Zugang erhalten

Um die LabelGrid-API zu nutzen, benötigen Sie:

1. Einen aktiven, kostenpflichtigen API-Tarif – API- und Sandbox-Zugang erfordern einen kostenpflichtigen API-Tarif. Die 7-tägige kostenlose Testphase, die zu Standardtarifen gehört, umfasst keinen API- oder Sandbox-Zugang, und API-Tarife werden sofort abgerechnet (keine Testphase).
2. Ein API-Token, das in Ihren Kontoeinstellungen generiert wird: Öffnen Sie das Avatar-Menü oben rechts und klicken Sie auf API-Tokens (nur sichtbar, wenn der API-Zugang aktiviert ist)
3. (Optional) IP-Whitelisting für zusätzliche Sicherheit – im selben Bereich konfigurierbar

Wenn Sie die Option „API-Tokens“ in Ihrem Konto nicht sehen, wenden Sie sich an den Support, um die Aktivierung des API-Zugangs für Ihren Tarif zu besprechen.

---

Authentifizierung

Alle API-Anfragen müssen einen Bearer-Token im Authorization-Header enthalten:

Authorization: Bearer YOUR_API_TOKEN

---

API-Dokumentation

Für die vollständige Endpunktreferenz, Request-/Response-Schemata und Live-„Try it“-Tooling siehe die automatisch generierte Dokumentation:

• Produktion: https://api.labelgrid.com/docs/api
• Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

Die Dokumentation umfasst:

• Anleitung zur Authentifizierung
• Jeden verfügbaren Endpunkt mit Request- und Response-Beispielen
• Informationen zur Rate-Begrenzung
• Webhook-Konfiguration

---

Sandbox

LabelGrid bietet eine Sandbox-Umgebung, damit Sie gegen die API entwickeln und testen können, ohne Ihren Produktivkatalog zu beeinträchtigen. Der Sandbox-Zugang erfordert einen aktiven API-Tarif und wird von uns auf Anfrage bereitgestellt – sobald Ihr API-Tarif aktiv ist, wenden Sie sich an den Support, um eine einzurichten. Das Sandbox-IP-Whitelisting konfigurieren wir für Sie; das Produktions-IP-Whitelisting ist im Selbstbedienungsverfahren unter API-Tokens möglich.

---

Webhooks

Die öffentliche API unterstützt Webhooks für die asynchrone Ereignisbenachrichtigung (Änderungen des Prüfstatus, Auslieferungsaktualisierungen usw.). Siehe Webhooks für die Einrichtung und die verfügbaren Ereignistypen.

---

FAQ

„Bietet LabelGrid eine öffentliche API?”

Ja — LabelGrid bietet eine öffentliche REST-API für den programmatischen Vertrieb, eingebunden unter /api/public/... auf api.labelgrid.com. Sie können Ihren Katalog lesen, Releases erstellen und aktualisieren, Audio und Artwork hochladen, Künstler und Mitwirkende verwalten, Webhooks registrieren und Releases zum Vertrieb einreichen. Die vollständige Dokumentation finden Sie unter api.labelgrid.com/docs/api.

„Wie erhalte ich API-Zugang?”

API- und Sandbox-Zugang erfordern einen aktiven, kostenpflichtigen API-Tarif. Sobald Ihr API-Tarif aktiv ist, generieren Sie in Ihren Kontoeinstellungen unter API-Tokens (im Avatar-Menü oben rechts) ein API-Token. Wenn Sie diese Option nicht sehen, wenden Sie sich an den Support, um den API-Zugang zu aktivieren. Die 7-tägige kostenlose Testphase der Standardtarife umfasst keinen API-Zugang.

„Wie authentifiziere ich API-Anfragen?”

Fügen Sie jeder Anfrage ein Bearer-Token im Authorization-Header hinzu: Authorization: Bearer YOUR_API_TOKEN. Generieren Sie das Token unter API-Tokens in Ihren Kontoeinstellungen und schränken Sie es optional per IP-Whitelisting ein.

„Gibt es eine Sandbox-Umgebung zum Testen?”

Ja. LabelGrid stellt eine Sandbox bereit, damit Sie gegen die API entwickeln und testen können, ohne Ihren Produktivkatalog zu beeinträchtigen. Der Sandbox-Zugang erfordert einen aktiven API-Tarif und wird auf Anfrage bereitgestellt — wenden Sie sich an den Support, sobald Ihr API-Tarif aktiv ist. Die Sandbox-Dokumentation finden Sie unter api-sandbox.stg.labelgrid.com/docs/api.

„Was kostet die LabelGrid-API?”

Die API ist über die API-Tarife von LabelGrid verfügbar, die jährlich abgerechnet werden. Die Tarife beginnen mit der Stufe Starter API, mit höheren Stufen für größere Kataloge und höhere Grenzen bei der Verarbeitung von Tantiemen. Aktuelle Preise und die Details der einzelnen Stufen finden Sie auf der Preisseite.

---

Verwandtes

Bauen Sie auf der LabelGrid-API auf? Sehen Sie sich den Developer Hub für einen Überblick über die Möglichkeiten an. Wenn Sie einen White-Label-Vertriebsdienst auf Basis von LabelGrid betreiben, behandelt die Seite Infrastruktur für Vertriebe das große Ganze. Siehe auch den Leitfaden White-Label-Vertrieb einrichten.

---

Brauchen Sie Hilfe?

Wenn Sie Unterstützung bei der API benötigen, wenden Sie sich an unser Support-Team mit technischen Details zu Ihrer Integration.