LABELGRID ENGINE · 음원 유통 API

Engine 소개: 음원 유통 API

음원 유통 API는 스트리밍 플랫폼에 음원을 프로그래밍 방식으로 전송하는 REST 인터페이스입니다. 카탈로그 메타데이터를 구성하고, 오디오를 업로드하고, 발매작을 전송용으로 제출하고, 로열티 데이터를 조회하는 모든 작업을 수작업이 아닌 코드로 처리합니다. LabelGrid는 유통 엔진 전체를 하나의 API로 공개하며, 공개 문서와 샌드박스를 함께 제공합니다.

모든 엔드포인트가 공개 문서로 정리되어 있습니다. 가입 전에 전체 레퍼런스를 읽어보실 수 있고, 데모 통화도 영업 관문도 양식 작성도 없습니다. 토큰으로 인증하면, 모든 API 플랜에 포함된 샌드박스에서 개발하고, 이미 모든 주요 DSP로 전송하고 있는 인프라 위에서 여러분의 브랜드로 유통 제품을 출시하실 수 있습니다.

API 문서 보기 API 요금제 보기

Engine API 흐름: POST로 발매작을 생성하고, 모든 주요 DSP로 전송이 완료되며, 웹훅이 앱에 알림을 보냅니다

무엇을 만들 수 있나요

Engine 위에서 유통 제품을 출시하세요

API가 전체 라이프사이클을 아우르므로, 만드는 제품은 간단한 동기화 작업부터 완전한 유통 프런트엔드까지 무엇이든 될 수 있습니다.

자체 브랜드 유통 플랫폼

여러분의 브랜드와 도메인으로 유통 서비스를 구축하세요. 사용자는 레이블과 발매작을 만들고, 트랙을 업로드하고, 전송을 요청하며, 처음부터 끝까지 여러분의 이름을 보게 됩니다. 브랜드와 가격, 고객 관계는 여러분의 것입니다. LabelGrid는 모든 주요 DSP로의 전송과 로열티 정산·지급, 그리고 모든 발매작에 적용되는 자동 검증과 수동 검수를 맡습니다.

레이블 관리 SaaS 연동

이미 운영 중인 제품에 유통 기능을 더하세요. 앱 안에서 발매작과 트랙 엔드포인트를 호출하면, 고객은 앱을 벗어나지 않고도 음원을 DSP에 올릴 수 있습니다.

카탈로그 마이그레이션 파이프라인

온보딩 때 기존 카탈로그를 DDEX 피드로 들여오셔도 되고, 임포트를 직접 스크립트로 짜셔도 됩니다. API로 발매작과 트랙을 한꺼번에 만들고 음원 파일을 업로드하는 작업을 한 번만 돌리거나 일정에 걸어 두실 수 있습니다.

로열티 리포팅 앱

정산 명세와 거래 내역, 계정 잔액을 자체 대시보드와 정산 로직으로 가져오세요. 스트리밍·참여도 분석과 결합하면 전체 그림을 한눈에 파악할 수 있습니다.

엔드포인트 그룹

API 구성 방식

모든 엔드포인트는 https://api.labelgrid.com/api/public 아래에 있으며 JSON을 반환합니다. 실제로 사용하게 될 그룹은 다음과 같습니다.

발매작 및 트랙

발매작과 트랙을 생성·조회·수정·삭제하세요. DSP 규칙에 따라 발매작을 검증하고 유통을 위해 제출합니다. 레퍼런스 →

파일 및 자산

발매작·트랙 파일 엔드포인트에서 오디오와 아트워크, 라이선스를 업로드하고 관리하세요. 필요할 때 자산을 다시 내려받을 수 있습니다. 레퍼런스 →

레이블, 아티스트 및 기여자

레이블과 아티스트, 작곡가, 퍼블리셔를 관리하고, 레이블·아티스트 이미지를 업로드하세요. 메타데이터에 크레딧으로 표기되는 대상들입니다. 레퍼런스 →

유통 및 심사

유통 큐를 추적하고 심사 이슈와 메모를 읽을 수 있으며, 웹훅을 등록하면 전송과 심사 상태 변경이 발생하는 즉시 여러분 쪽으로 전달됩니다. 폴링 없이도 사용자가 발매 진행 상황을 확인합니다. 레퍼런스 →

분석 및 정산

스트리밍·참여도 분석과 로열티 명세, 거래 내역, 계정 잔액을 조회하여 자체 리포팅과 정산에 활용하세요. 스트리밍 애널리틱스는 /api/public/analytics 경로에 있습니다. 요약(summary), 지표별 시리즈, 리더보드, 플레이스먼트, 그리고 어떤 스토어가 어떤 지표를 지원하는지 알려주는 가용성(availability) 엔드포인트까지 갖췄습니다. 레퍼런스 →

웹훅 및 참조 데이터

심사 상태와 전송 이벤트에 대한 웹훅을 등록하고, 장르·언어·기여자 역할·지역·유통처 목록을 불러와 메타데이터를 채우세요. 레퍼런스 →

AI 네이티브 레이어

같은 API를 자연어로 다루세요

REST API로 할 수 있는 모든 일을 AI 어시스턴트도 할 수 있습니다. LabelGrid 공식 MCP 서버는 이 API를 감싼 얇고 타입이 지정된 래퍼이므로, Claude, Cursor 등 Model Context Protocol 클라이언트에서 요청만으로 발매작 생성, 메타데이터 검증, 분석 데이터 조회, 전송 상태 확인이 가능합니다. 권한은 계층으로 나뉘고 기본값은 차단입니다. 읽기는 항상 열려 있고, 안전한 초안 쓰기는 기본으로 켜져 있으며 원하시면 끄거나 읽기 전용으로 고정할 수 있습니다. 어시스턴트가 전송을 제출하고 게시 중단을 접수하는 일은 해당 스코프를 직접 켜신 뒤에만 가능합니다. 문구를 직접 입력해 확인하는 일회성 동의를 거치고 나면, 그다음부터는 다른 호출과 똑같이 동작합니다. 켜기 전까지는 꺼진 상태 그대로이므로 탐색 삼아 돌린 세션이 실수로 음원을 내보내는 일은 일어나지 않습니다. 모든 검증은 여전히 LabelGrid 서버에서 실행됩니다.

MCP 서버 살펴보기

표준 및 검증

DSP가 요구하는 표준을 기반으로 구축

LabelGrid는 3.8.2, 4.3.0, 4.3.1, 4.3.2 버전의 표준을 준수하는 DDEX ERN 피드를 생성하며, NewReleaseMessage와 PurgeReleaseMessage를 완벽히 지원합니다. ISRC와 UPC 값은 발매 과정에서 검증되고, validate 엔드포인트는 제출 전에 발매작을 DSP 메타데이터 품질 규칙에 따라 점검합니다. 지적된 부분을 수정해 다시 제출하면 전송됩니다. 기존 카탈로그를 옮기는 경우 온보딩 단계에서 DDEX 임포트로 가져올 수 있습니다. 자세한 내용은 DDEX 임포트 가이드를 참고하세요.

UI를 직접 만들고 싶지 않으신가요?

Imprint는 노코드 버전입니다

이 API가 하는 모든 것을 자체 도메인에서 바로 쓸 수 있는 화이트라벨 포털로 담아낸 제품이 Imprint입니다. Engine으로 개발하고 Imprint로 출시하거나, 둘을 함께 사용하세요.

Imprint 살펴보기

카탈로그를 보호하세요

카탈로그를 깨끗하게 지키는 애드온

Preflight QC

모든 발매작은 이미 LabelGrid의 자동 검증과 수동 검수를 거치며, 이는 모든 플랜에 포함됩니다. Preflight QC는 여기에 전송 전 자동 점검을 더합니다. 음질, 메타데이터, 크레딧과 권리 처리, AI 사용 고지, 아트워크를 확인하며, API 플랜과 화이트라벨 플랜의 애드온으로 월 발매량에 맞춰 범위를 정하고 발매 건당 비용은 없습니다.

Preflight QC 살펴보기 →

Stream Radar

인위적 스트리밍 조기 경보 기능입니다. 카탈로그 전체를 상시 모니터링하여 인위적 스트리밍과 일치하는 패턴이 나타나는 트랙과 음원을 표시합니다. 수수료나 게시 중단이 닥치기 전에 조치할 수 있습니다.

Stream Radar 살펴보기 →

API 플랜

모든 단계에 맞는 요금제

전체 API 접근 권한과 샌드박스, 영업일 기준 2일 이내 첫 응답이 모든 등급에 들어갑니다. 트랙 수와 레이블 포털 수는 한계선이 아니라 기본 제공량입니다. 레이블 팩으로 어느 등급에서든 포털을 더할 수 있고(Starter +5개 $28, Growth +10개 $90, Scale +25개 $170), 등급을 올리면 둘 다 함께 늘어나며, Custom API는 트랙 한도를 별도로 정하고 레이블 수에 제한이 없습니다. 모든 API 플랜은 초과분을 제외하고 연간 결제이며, LabelGrid의 DSP 계약을 통해 발생한 로열티는 95%를, 직접 맺으신 계약에서는 100%를 가져가십니다.

Starter API

$139/월
초과분 제외 연간 청구

전체 API 접근 권한과 샌드박스, 트랙 3,000개와 레이블 포털 5개 기본 제공, 월 $35k까지 로열티 처리, 영업일 기준 2일 이내 첫 응답.

공식 MCP 서버 — AI 어시스턴트 지원

Growth API

$389/월
초과분 제외 연간 청구

Starter의 모든 구성에 더해 트랙 10,000개와 레이블 포털 25개 기본 제공, 월 $115k까지 로열티 처리, 영업일 기준 2일 이내 첫 응답.

공식 MCP 서버 — AI 어시스턴트 지원

Scale API

$879/월
초과분 제외 연간 청구

Growth의 모든 구성에 더해 트랙 25,000개와 레이블 포털 100개 기본 제공, 월 $350k까지 로열티 처리, 영업일 기준 2일 SLA의 전담 테크니컬 어카운트 매니저.

공식 MCP 서버 — AI 어시스턴트 지원

전체 API 요금제 보기

많이 하시는 질문

자주 묻는 질문

어떤 종류의 API인가요?

HTTPS로 JSON을 주고받는 REST API입니다. 모든 엔드포인트는 https://api.labelgrid.com/api/public 아래에 있습니다. 인증은 API 토큰을 Authorization 헤더에 Bearer 토큰으로 담아 보내는 방식이라, curl이든 쓰시던 HTTP 클라이언트든 어떤 언어의 표준 라이브러리든 첫 호출부터 그대로 동작하고, 따로 설치할 것은 없습니다.

플랫폼을 화이트라벨로 운영할 수 있나요?

네, 두 가지 방법이 있습니다. API 위에 인터페이스를 직접 만드셔도 되고, 완성형 화이트라벨 포털 Imprint를 코드 없이 여러분의 도메인에 띄우셔도 됩니다. 도메인, 로고, 지정한 색상과 폰트, 직접 만든 요금제와 가격, 그리고 여러분의 Stripe 계정으로 들어오는 고객 결제까지 전부 여러분의 것입니다. 두 방식 모두 같은 전송·정산·DSP 연결 위에서 돌아가므로, 아티스트와 레이블은 가입부터 정산까지 여러분의 브랜드만 보고 LabelGrid는 보지 않습니다. Imprint는 대기자 명단을 통해 지금 리셀러를 온보딩하고 있으며, 새로 여는 포털마다 저희가 직접 셋업을 도와드립니다.

API 이용 요금은 얼마인가요?

API를 이용하려면 API 플랜이 필요합니다. Starter API(월 $139), Growth API(월 $389), Scale API(월 $879), Custom API(월 $2,149+) 중에서 선택할 수 있으며, 모두 연간 결제입니다. 이 수치는 전부 공개되어 있습니다. Starter는 트랙 3,000개와 레이블 포털 5개, 월 $35k까지의 로열티 처리를 포함하고, Growth는 트랙 10,000개와 포털 25개에 $115k까지, Scale은 트랙 25,000개와 포털 100개에 $350k까지이며 전담 테크니컬 어카운트 매니저가 붙습니다. Custom API는 트랙 한도를 별도로 정하고 레이블 수에 제한이 없습니다. 모든 등급이 영업일 기준 2일 이내 첫 응답을 제공하고, 레이블 팩은 어느 등급에서든 포털을 더해 줍니다. 모든 API 플랜에는 LabelGrid의 DSP 계약을 통한 전송에서 로열티 95%, 고객님의 직접 계약에서 100%를 받는 조건이 포함됩니다. 자세한 내용은 요금제 페이지를 확인하세요.

어떤 DSP에 전송할 수 있나요?

LabelGrid는 Spotify, Apple Music, Amazon Music, Deezer, Tidal, YouTube Music, TikTok, Instagram을 비롯한 모든 주요 디지털 음원 플랫폼에 전송합니다. Spotify Preferred 유통사이자 Merlin 회원사로서, LabelGrid는 우선 전송과 에디토리얼 피칭 도구를 제공합니다. 동일한 네트워크를 API로도 이용할 수 있습니다.

카탈로그가 API 플랜 한도를 넘어서면 어떻게 되나요?

상위 등급으로 올리시면 됩니다. Starter는 트랙 3,000개와 레이블 포털 5개, Growth는 트랙 10,000개와 포털 25개, Scale은 트랙 25,000개와 포털 100개를 포함하고, Custom API는 트랙 한도를 별도로 정하며 레이블 수에 제한이 없습니다. 레이블 포털은 등급을 그대로 두고 레이블 팩으로 늘릴 수도 있습니다. Starter는 +5개에 $28, Growth는 +10개에 $90, Scale은 +25개에 $170입니다. 월 로열티 처리 한도도 등급을 따라가 Starter $35k, Growth $115k, Scale $350k이며, Custom API는 협의해서 정합니다.

API 플랜에는 어떤 지원이 포함되나요?

모든 API 등급에 영업일 기준 2일 이내 첫 응답을 드리는 이메일 지원이 포함됩니다. Scale API에는 같은 영업일 기준 2일 SLA로 전담 테크니컬 어카운트 매니저가 배정되고, Custom API는 협의한 조건으로 지원합니다.

플랜을 결제하기 전에 API를 먼저 볼 수 있나요?

네. 전체 엔드포인트 레퍼런스는 api.labelgrid.com/docs/api 에 공개되어 있습니다. 모든 그룹과 경로, 메서드를 로그인도 데모 통화도 양식 작성도 없이 보실 수 있습니다. API 요금제도 공개되어 있어 같은 자리에서 플랜 규모까지 가늠하실 수 있습니다. 샌드박스는 API 플랜과 함께 제공되며, API 기능이 활성화된 계정이 필요합니다.

Engine 위에서 개발을 시작하세요

문서를 확인하세요. 샌드박스에서 개발하세요. 공개 요금제를 살펴보세요.

API 문서 보기 문의하기 API 요금제 보기

화이트라벨 및 API 살펴보기 →