LABELGRID ENGINE · 음원 유통 API
Engine 소개: 음원 유통 API
음원 유통 API는 스트리밍 플랫폼에 음원을 프로그래밍 방식으로 전송하는 REST 인터페이스입니다. 카탈로그 메타데이터를 구성하고, 오디오를 업로드하고, 발매작을 전송용으로 제출하고, 로열티 데이터를 조회하는 모든 작업을 수작업이 아닌 코드로 처리합니다. LabelGrid는 유통 엔진 전체를 하나의 API로 공개하며, 공개 문서와 샌드박스를 함께 제공합니다.
모든 엔드포인트가 공개 문서로 정리되어 있습니다. 가입 전에 전체 레퍼런스를 읽어보실 수 있고, 데모 통화도 영업 관문도 양식 작성도 없습니다. 토큰으로 인증하면, 모든 API 플랜에 포함된 샌드박스에서 개발하고, 이미 모든 주요 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 서버에서 실행됩니다.
표준 및 검증
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로 출시하거나, 둘을 함께 사용하세요.
카탈로그를 보호하세요
카탈로그를 깨끗하게 지키는 애드온
Preflight QC
모든 발매작은 이미 LabelGrid의 자동 검증과 수동 검수를 거치며, 이는 모든 플랜에 포함됩니다. Preflight QC는 여기에 전송 전 자동 점검을 더합니다. 음질, 메타데이터, 크레딧과 권리 처리, AI 사용 고지, 아트워크를 확인하며, API 플랜과 화이트라벨 플랜의 애드온으로 월 발매량에 맞춰 범위를 정하고 발매 건당 비용은 없습니다.
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 어시스턴트 지원
많이 하시는 질문