API の概要とクイックスタート
2026年7月更新。
はい。LabelGrid は、プログラムから配信を扱える公開 REST API を提供しています。開発者はこの API を使って、カタログの読み取り、リリースの作成と更新、アセットのアップロード、配信への申請が行えます。LabelGrid の上に構築されたホワイトラベルのサービスも、この API で動いています。このガイドはクイックスタートです。エンドポイントの完全なリファレンスは api.labelgrid.com/docs/api にあります。
クイックスタートの概要
Section titled “クイックスタートの概要”| ステップ | 操作内容 |
|---|---|
| 1. API プランを有効にする | API とサンドボックスへのアクセスには、有効な有料 API プラン（年額請求）が必要です。 |
| 2. API トークンを生成する | 右上のアバターメニューを開き、API Tokens をクリックして Bearer トークンを作成します。 |
| 3.（任意）IP をホワイトリストに登録する | 同じ API Tokens の画面で、トークンの利用を既知の IP に制限します。 |
| 4. リファレンスを読む | api.labelgrid.com/docs/api でエンドポイントと「try it」ツールを確認します。 |
| 5. サンドボックスで開発する | サポートにサンドボックスを依頼し、本番に触れずにテストします。 |
| 6. 本番へ移行する | 連携先を api.labelgrid.com に切り替えて、最初のリリースを作成します。 |
API でできること
Section titled “API でできること”公開 API は api.labelgrid.com の /api/public/... にマウントされており、次へのプログラムによるアクセスを提供します。
- Releases — 一覧、作成、更新、削除、アートワークのアップロード、検証、配信への申請
- Tracks — 一覧、作成、更新、音声ファイルのアップロード、トラックライセンスの管理
- Labels — レーベルプロフィールの一覧と管理
- Artists — アーティストプロフィールの一覧と管理
- Writers と Contributors — 作家/貢献者プロフィールの一覧と管理
- Publishers — 出版社プロフィールの一覧と管理
- Webhooks — 非同期通知のための Webhook エンドポイントの登録
- リファレンスデータ — ジャンル、言語、貢献者の役割、楽器、配信地域、配信先
よくあるユースケース
Section titled “よくあるユースケース”- 既存システムからのリリース作成を自動化する
- カタログデータをデータベースと同期する
- カスタムのダッシュボードやレポートツールを構築する
- 既存のワークフローツールと連携する
- LabelGrid の上にホワイトラベルの配信サービスを構築する
API アクセスを取得する
Section titled “API アクセスを取得する”LabelGrid API を使うには、次が必要です。
- 有効な有料 API プラン — API およびサンドボックスへのアクセスには有料 API プランが必要です。標準プランに付属する7日間の無料トライアルには API やサンドボックスへのアクセスは 含まれず、API プランは（トライアル期間なしで）即時に課金されます。
- アカウント設定から生成する API トークン：右上のアバターメニューを開き、API Tokens をクリックします（API アクセスが有効な場合のみ表示されます）
- （任意）セキュリティ強化のための IP ホワイトリスト — 同じ画面で設定します
アカウントに API Tokens のオプションが表示されない場合は、サポートに連絡して、プランで API アクセスを有効にできるかご相談ください。
すべての API リクエストには、Authorization ヘッダーに Bearer トークンを含める必要があります。
Authorization: Bearer YOUR_API_TOKENAPI ドキュメント
Section titled “API ドキュメント”エンドポイントの完全なリファレンス、リクエスト/レスポンスのスキーマ、ライブの「try it」ツールについては、自動生成されたドキュメントをご覧ください。
ドキュメントには次が含まれます。
- 認証ガイド
- 利用可能なすべてのエンドポイントとリクエスト/レスポンスの例
- レート制限の情報
- Webhook の設定
サンドボックス
Section titled “サンドボックス”LabelGrid は、本番カタログに影響を与えずに API に対して構築とテストができるよう、サンドボックス環境を提供します。サンドボックスへのアクセスには有効な API プランが必要で、ご依頼に応じて私たちがプロビジョニングします。API プランが有効になったら、サポートに連絡してセットアップを依頼してください。サンドボックスの IP ホワイトリストは私たちが設定します。本番の IP ホワイトリストは API Tokens からセルフサービスで設定できます。
Webhook
Section titled “Webhook”公開 API は、非同期のイベント通知（レビューステータスの変更、配信の更新など）のための Webhook をサポートします。セットアップと利用可能なイベントタイプについては Webhooks をご覧ください。
「LabelGrid に公開 API はありますか？」
Section titled “「LabelGrid に公開 API はありますか？」”はい。LabelGrid は、プログラムから配信を扱える公開 REST API を提供しています。api.labelgrid.com の /api/public/... にマウントされており、カタログの読み取り、リリースの作成と更新、音声とアートワークのアップロード、アーティストと貢献者の管理、Webhook の登録、配信への申請が行えます。完全なドキュメントは api.labelgrid.com/docs/api にあります。
「API アクセスはどうすれば取得できますか？」
Section titled “「API アクセスはどうすれば取得できますか？」”API とサンドボックスへのアクセスには、有効な有料 API プランが必要です。API プランが有効になったら、アカウント設定の API Tokens（右上のアバターメニュー内）から API トークンを生成してください。この項目が表示されない場合は、サポートに連絡して API アクセスを有効にしてもらってください。標準プランに付属する7日間の無料トライアルには API アクセスは含まれません。
「API リクエストの認証はどのように行いますか？」
Section titled “「API リクエストの認証はどのように行いますか？」”すべてのリクエストの Authorization ヘッダーに Bearer トークンを含めてください：Authorization: Bearer YOUR_API_TOKEN。トークンはアカウント設定の API Tokens で生成でき、任意で IP ホワイトリストによる制限もかけられます。
「テスト用のサンドボックス環境はありますか？」
Section titled “「テスト用のサンドボックス環境はありますか？」”はい。LabelGrid は、本番カタログに影響を与えずに API に対して構築とテストができるサンドボックスを提供しています。サンドボックスへのアクセスには有効な API プランが必要で、ご依頼に応じてプロビジョニングします。API プランが有効になったらサポートまでご連絡ください。サンドボックスのドキュメントは api-sandbox.stg.labelgrid.com/docs/api にあります。
「LabelGrid の API の料金はいくらですか？」
Section titled “「LabelGrid の API の料金はいくらですか？」”API は LabelGrid の API プランでご利用いただけます。請求は年額です。最小の Starter API ティアから、カタログ規模やロイヤリティの処理量が大きいお客様向けの上位ティアまで用意しています。現在の価格と各ティアの詳細は料金ページをご覧ください。
LabelGrid API の上に何かを構築していますか？ できることの概要は 開発者ハブ をご覧ください。LabelGrid の上にホワイトラベルの配信サービスを構築している場合は、ディストリビューター向けインフラ ページが全体像を扱っています。あわせて white-label 配信のセットアップのガイドもご覧ください。
サポートが必要ですか？
Section titled “サポートが必要ですか？”API に関するサポートが必要な場合は、連携の技術的な詳細を添えて サポートチームにお問い合わせください。