Aperçu de l'API et démarrage rapide

Mis à jour en juillet 2026.

Oui — LabelGrid propose une API publique REST pour la distribution programmatique. Elle permet aux développeurs de consulter votre catalogue, de créer et mettre à jour des sorties, d’importer des ressources et de soumettre des sorties à la distribution, et elle alimente les services en marque blanche bâtis sur LabelGrid. Ce guide est le démarrage rapide ; la référence complète des endpoints se trouve sur api.labelgrid.com/docs/api.

Le démarrage rapide en un coup d’œil

Étape	Ce que vous faites
1. Activer un forfait API	L’accès à l’API et au sandbox nécessite un forfait API actif et payant (facturé annuellement).
2. Générer un jeton API	Ouvrez le menu de l’avatar (en haut à droite) et cliquez sur Jetons API pour créer un jeton Bearer.
3. (Facultatif) Filtrage d’IP	Restreignez l’usage du jeton à des IP connues dans la même zone Jetons API.
4. Lire la référence	Explorez les endpoints et l’outillage « essayer » sur api.labelgrid.com/docs/api.
5. Développer sur le sandbox	Demandez un sandbox au support, puis testez sans toucher la production.
6. Passer en production	Pointez votre intégration vers api.labelgrid.com et créez votre première sortie.

Vous préférez le langage naturel au REST brut ?

LabelGrid publie aussi un serveur MCP officiel qui connecte des clients IA comme Claude Desktop, Claude Code et Cursor à cette API. Vous décrivez ce que vous voulez en langage naturel — préparer une sortie, la valider, récupérer des statistiques — et votre assistant IA effectue les appels API pour vous. Voir Connecter votre assistant IA à LabelGrid (MCP).

Ce que propose l’API

L’API publique est exposée sous /api/public/... sur api.labelgrid.com et offre un accès programmatique à :

• Sorties — lister, créer, mettre à jour, supprimer ; importer la pochette ; valider ; soumettre à la distribution
• Pistes — lister, créer, mettre à jour ; importer des fichiers audio ; gérer les licences de pistes
• Labels — lister et gérer vos profils de label
• Artistes — lister et gérer les profils d’artistes
• Auteurs et contributeurs — lister et gérer les profils d’auteurs/contributeurs
• Éditeurs — lister et gérer les profils d’éditeurs
• Webhooks — enregistrer des points de terminaison webhook pour des notifications asynchrones
• Analytics — données de streaming, de listeners et d’engagement par jour, par plateforme, par pays et par titre ; voir API Analytics : filtres de périmètre et données par titre et API Analytics : plateformes, disponibilité et limites
• Données de référence — genres, langues, rôles de contributeurs, instruments, territoires de distribution, points de vente distro

Cas d’usage courants

• Automatiser la création de sorties depuis vos systèmes existants
• Synchroniser les données de catalogue avec votre base de données
• Créer des tableaux de bord et des outils de reporting sur mesure
• Vous intégrer à vos outils de workflow existants
• Alimenter des services de distribution en marque blanche bâtis sur LabelGrid

---

Obtenir l’accès à l’API

Pour utiliser l’API de LabelGrid, il vous faut :

1. Un forfait API actif et payant — l’accès à l’API et au sandbox nécessite un forfait API payant. L’essai gratuit de 7 jours fourni avec les forfaits standard ne comprend pas l’accès à l’API ni au sandbox, et les forfaits API sont facturés immédiatement (pas de période d’essai).
2. Un jeton API généré depuis les réglages de votre compte : ouvrez le menu de l’avatar en haut à droite et cliquez sur Jetons API (visible uniquement si l’accès API est activé)
3. (Facultatif) Le filtrage d’adresses IP pour plus de sécurité — à configurer dans la même zone

Si l’option Jetons API n’apparaît pas dans votre compte, contactez le support pour discuter de l’activation de l’accès API sur votre forfait.

---

Authentification

Toutes les requêtes API doivent inclure un jeton Bearer dans l’en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

---

Documentation de l’API

Pour la référence complète des points de terminaison, les schémas de requête/réponse et l’outillage « essayer en direct », consultez la documentation générée automatiquement :

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

La documentation comprend :

• Un guide d’authentification
• Chaque point de terminaison disponible avec des exemples de requête et de réponse
• Des informations sur la limitation du débit (rate limiting)
• La configuration des webhooks

---

Sandbox

LabelGrid propose un environnement sandbox pour vous permettre de développer et de tester avec l’API sans affecter votre catalogue de production. L’accès au sandbox nécessite un forfait API actif et est provisionné par nos soins sur demande — une fois votre forfait API actif, contactez le support pour en configurer un. Nous configurons le filtrage d’IP du sandbox pour vous ; le filtrage d’IP de production est en libre-service sous Jetons API.

---

Webhooks

L’API publique prend en charge les webhooks pour la notification asynchrone d’événements (changements de statut de révision, mises à jour de livraison, etc.). Consultez Webhooks pour la configuration et les types d’événements disponibles.

---

FAQ

« LabelGrid dispose-t-il d’une API publique ? »

Oui — LabelGrid propose une API publique REST pour la distribution programmatique, exposée sous /api/public/... sur api.labelgrid.com. Vous pouvez consulter votre catalogue, créer et mettre à jour des sorties, importer audio et pochettes, gérer artistes et contributeurs, enregistrer des webhooks et soumettre des sorties à la distribution. La documentation complète est disponible sur api.labelgrid.com/docs/api.

« Comment obtenir l’accès à l’API ? »

L’accès à l’API et au sandbox nécessite un forfait API actif et payant. Une fois votre forfait API actif, générez un jeton API depuis les réglages de votre compte sous Jetons API (dans le menu de l’avatar, en haut à droite). Si l’option n’apparaît pas, contactez le support pour activer l’accès à l’API. L’essai gratuit de 7 jours des forfaits standard ne comprend pas l’accès à l’API.

« Comment authentifier les requêtes à l’API ? »

Incluez un jeton Bearer dans l’en-tête Authorization de chaque requête : Authorization: Bearer YOUR_API_TOKEN. Générez le jeton sous Jetons API dans les réglages de votre compte et, en option, restreignez-le par filtrage d’adresses IP.

« Existe-t-il un environnement sandbox pour les tests ? »

Oui. LabelGrid propose un sandbox pour développer et tester avec l’API sans affecter votre catalogue de production. L’accès au sandbox nécessite un forfait API actif et est provisionné sur demande — contactez le support une fois votre forfait API actif. La documentation du sandbox est disponible sur api-sandbox.stg.labelgrid.com/docs/api.

« Combien coûte l’API de LabelGrid ? »

L’API est disponible avec les forfaits API de LabelGrid, facturés annuellement. Les forfaits commencent au niveau Starter API, avec des niveaux supérieurs pour les catalogues plus importants et des limites de traitement des redevances plus élevées. Consultez la page des tarifs pour les prix actuels et le détail de chaque niveau.

---

En lien

Vous développez sur l’API de LabelGrid ? Consultez le hub développeurs pour un aperçu des possibilités. Si vous alimentez un service de distribution en marque blanche bâti sur LabelGrid, la page infrastructure pour distributeurs couvre la vue d’ensemble. Voir aussi le guide Configuration de la distribution en marque blanche.

---

Besoin d’aide ?

Si vous avez besoin d’aide concernant l’API, contactez notre équipe de support avec les détails techniques de votre intégration.