API-overzicht en snelstart

Bijgewerkt in juli 2026.

Ja — LabelGrid biedt een publieke REST-API voor programmatische distributie. Ontwikkelaars kunnen er je catalogus mee lezen, releases aanmaken en bijwerken, assets uploaden en releases indienen voor distributie, en de API vormt de basis onder white-labeldiensten die op LabelGrid zijn gebouwd. Deze gids is de snelstart; de volledige endpointreferentie staat op api.labelgrid.com/docs/api.

De snelstart in het kort

Stap	Wat je doet
1. Een API-abonnement activeren	API- en sandboxtoegang vereisen een actief, betaald API-abonnement (jaarlijkse facturatie).
2. Een API-token genereren	Open het avatarmenu (rechtsboven) en klik op API-tokens om een Bearer-token aan te maken.
3. (Optioneel) IP’s whitelisten	Beperk het gebruik van het token tot bekende IP’s onder datzelfde onderdeel API-tokens.
4. De referentie lezen	Verken de endpoints en de “try it”-functie op api.labelgrid.com/docs/api.
5. Ontwikkelen op de sandbox	Vraag een sandbox aan bij support en test zonder productie aan te raken.
6. Naar productie gaan	Laat je integratie naar api.labelgrid.com wijzen en maak je eerste release aan.

Liever gewone taal dan kale REST-aanroepen?

LabelGrid publiceert ook een officiële MCP-server die AI-clients zoals Claude Desktop, Claude Code en Cursor met deze API verbindt. Je beschrijft in gewone taal wat je wilt — een release opstellen, valideren, analytics ophalen — en je AI-assistent doet de API-aanroepen voor je. Zie Koppel je AI-assistent aan LabelGrid (MCP).

Wat de API biedt

De publieke API is beschikbaar onder /api/public/... op api.labelgrid.com en biedt programmatische toegang tot:

• Releases — weergeven, aanmaken, bijwerken, verwijderen; artwork uploaden; valideren; indienen voor distributie
• Tracks — weergeven, aanmaken, bijwerken; audiobestanden uploaden; tracklicenties beheren
• Labels — je labelprofielen weergeven en beheren
• Artiesten — artiestenprofielen weergeven en beheren
• Schrijvers en bijdragers — schrijvers-/bijdragerprofielen weergeven en beheren
• Uitgevers — uitgeversprofielen weergeven en beheren
• Webhooks — webhook-endpoints registreren voor asynchrone meldingen
• Referentiegegevens — genres, talen, bijdragerrollen, instrumenten, distributiegebieden, distributiekanalen

Veelvoorkomende toepassingen

• Het aanmaken van releases automatiseren vanuit je bestaande systemen
• Catalogusgegevens synchroniseren met je database
• Eigen dashboards en rapportagetools bouwen
• Integreren met je bestaande workflowtools
• White-label distributiediensten aandrijven bovenop LabelGrid

---

API-toegang krijgen

Om de LabelGrid API te gebruiken, heb je nodig:

1. Een actief, betaald API-abonnement — API- en sandboxtoegang vereisen een betaald API-abonnement. De gratis proefperiode van 7 dagen die bij standaardabonnementen hoort, omvat geen API- of sandboxtoegang, en API-abonnementen worden direct gefactureerd (geen proefperiode).
2. Een API-token dat je genereert in je accountinstellingen: open het avatarmenu rechtsboven en klik op API-tokens (alleen zichtbaar als API-toegang is ingeschakeld)
3. (Optioneel) IP-whitelisting voor extra beveiliging — in te stellen onder hetzelfde onderdeel

Als je de optie API-tokens niet in je account ziet, neem dan contact op met support om API-toegang op je abonnement te bespreken.

---

Authenticatie

Alle API-verzoeken moeten een Bearer-token bevatten in de Authorization-header:

Authorization: Bearer YOUR_API_TOKEN

---

API-documentatie

Voor de volledige endpointreferentie, request-/responseschema’s en live “try it”-tooling, zie de automatisch gegenereerde documentatie:

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

De documentatie bevat:

• Authenticatiehandleiding
• Elk beschikbaar endpoint met request- en responsevoorbeelden
• Informatie over rate limiting
• Webhookconfiguratie

---

Sandbox

LabelGrid biedt een sandboxomgeving zodat je tegen de API kunt bouwen en testen zonder je productiecatalogus te beïnvloeden. Sandboxtoegang vereist een actief API-abonnement en wordt op verzoek door ons ingericht — zodra je API-abonnement actief is, neem dan contact op met support om er een op te zetten. Wij stellen de sandbox-IP-whitelisting voor je in; de IP-whitelisting voor productie is selfservice onder API-tokens.

---

Webhooks

De publieke API ondersteunt webhooks voor asynchrone meldingen van gebeurtenissen (wijzigingen in reviewstatus, leveringsupdates enzovoort). Zie Webhooks voor de instelling en de beschikbare gebeurtenistypen.

---

FAQ

”Heeft LabelGrid een publieke API?”

Ja — LabelGrid biedt een publieke REST-API voor programmatische distributie, beschikbaar onder /api/public/... op api.labelgrid.com. Je kunt je catalogus lezen, releases aanmaken en bijwerken, audio en artwork uploaden, artiesten en bijdragers beheren, webhooks registreren en releases indienen voor distributie. De volledige documentatie vind je op api.labelgrid.com/docs/api.

”Hoe krijg ik API-toegang?”

API- en sandboxtoegang vereisen een actief, betaald API-abonnement. Zodra je API-abonnement actief is, genereer je een API-token in je accountinstellingen onder API-tokens (in het avatarmenu rechtsboven). Zie je die optie niet, neem dan contact op met support om API-toegang in te schakelen. De gratis proefperiode van 7 dagen op standaardabonnementen omvat geen API-toegang.

”Hoe authenticeer ik API-verzoeken?”

Zet in elk verzoek een Bearer-token in de Authorization-header: Authorization: Bearer YOUR_API_TOKEN. Je genereert het token onder API-tokens in je accountinstellingen en kunt het optioneel beperken met IP-whitelisting.

”Is er een sandboxomgeving om te testen?”

Ja. LabelGrid biedt een sandbox zodat je op de API kunt ontwikkelen en testen zonder je productiecatalogus te beïnvloeden. Sandboxtoegang vereist een actief API-abonnement en wordt op verzoek ingericht — neem contact op met support zodra je API-abonnement actief is. De sandboxdocumentatie staat op api-sandbox.stg.labelgrid.com/docs/api.

”Wat kost de LabelGrid API?”

De API is beschikbaar op de API-abonnementen van LabelGrid, die jaarlijks worden gefactureerd. De abonnementen beginnen bij Starter API, met hogere niveaus voor grotere catalogi en ruimere limieten voor royaltyverwerking. Kijk op de prijzenpagina voor de actuele prijzen en de details per niveau.

---

Gerelateerd

Bouw je op de LabelGrid API? Zie de developer hub voor een overzicht van de mogelijkheden. Bouw je bovenop LabelGrid een white-label distributiedienst, dan behandelt de pagina infrastructuur voor distributeurs het grotere geheel. Zie ook de gids White-labeldistributie instellen.

---

Hulp nodig?

Heb je API-hulp nodig, neem dan contact op met ons supportteam met technische details over je integratie.