LabelGrid API
LabelGrid API Documentation
LabelGrid API provides comprehensive endpoints for content providers to manage their audio catalogs, releases, distribution, and analytics. This RESTful API supports catalog management, track and release operations, distribution workflows, and integrations with external music services.
Prerequisites
The following prerequisites are required to use the LabelGrid API:
- You must have an active LabelGrid account
- API features enabled on your account
- IP allowlisting (if using sandbox environment)
Authorization
All endpoints require authentication via API tokens. Include your token in the Authorization header as a Bearer token. You may generate and manage your API tokens in your LabelGrid account settings or Sandbox account settings.
NOTICE For experimenting and testing purposes, we highly recommend using the sandbox environment. See the "Sandbox Access" section below for details.
Sandbox Access
Sandbox IP Allowlisting
Contact support to allowlist any IP addresses you will be using to access the sandbox resources.
NOTE Allowlisting is only needed for sandbox access.
Sandbox API
You can use the following sandbox version of our API to create and manage resources without affecting your production data.
Sandbox Frontend
You can use the following sandbox version of our frontend to check your catalogue after creating resources via the API.
Keeping Your Data Secure
IMPORTANT LabelGrid takes data security seriously. Ensure you follow best practices for API key management.
- Never expose your API keys in public repositories or client-side code.
- Only use your key within server-side code to keep your keys secure.
- Do not share your API keys with unauthorized parties.
- Never hard-code API keys in your applications.
- Use environment variables or secure vaults to store sensitive information.
- Regularly rotate your API keys and monitor their usage.
Features Overview
- Catalog Management: Create, update, and delete artists, labels, publishers, and writers.
- Release Operations: Manage releases, including track listings, metadata, and cover art.
- Distribution Workflows: Submit releases for distribution to various music services and platforms.
For more information, visit our LabelGrid Help Center or contact our support team.
API Changelog
Track breaking changes, deprecations, additions, and fixes to the Public API:
- HTML: /changelog
- Atom feed: /changelog.atom
Authenticated public-API responses also advertise the feed via an RFC 8288 Link: </changelog.atom>; rel="changelog" header.
API groups
Artists
Writers
Labels
Publishers
Releases
Track Files
Track Licenses
Tracks
Animated Covers
Distro Outlets
Distro Queue
Site Settings
User Info
Webhooks
Manage outbound webhooks for delivery and lifecycle events