Skip to content

KiTbetter Developers

Connect your platform to the KiTalbum release flow.

The KiTbetter Partner API helps approved partners integrate their website, platform, or internal system with KiTbetter. Partners can send artist and release metadata, create or connect KiTbetter Artists profiles, and generate KiTalbum drafts for completion inside KiTbetter Artists.

Use these docs to issue API keys, authenticate requests, submit DDEX ERN metadata, manage member integration, and track processing status.

Documentation guide

Section Contents
Get started Introduction to the KiTbetter Partner API, core concepts, and a guide through your first request
Authentication Issuing, using, and securing API keys
Guides Use-case tutorials, code examples by language, member integration, and webhooks
API Reference Endpoint reference (Redoc), data models, error codes, and rate limits
Resources Changelog, server status, and FAQ
Support Announcements, contact channels, and issue reporting
Policies & terms API usage policy, privacy policy, terms of service, and content license

Quickstart

Step 1 — Get an API key

Request an API key in the authentication guide.

Step 2 — Send your first request

Ingest an album with a presigned URL to your DDEX ERN XML. Pass your key in the X-API-Key header.

curl -X POST "https://api.kitbetter.com/partner/v1/ddex/ingests" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 35 \
  -d '{
    "releaseId": "DIST-2026-00123",
    "xmlUrl": "https://your-bucket.s3.amazonaws.com/ern/abc.xml?X-Amz-Expires=3600"
  }'

Step 3 — Check the response

A 201 means the album has been created in production. Resource files are loaded asynchronously afterwards; poll the status with the ingestId, or get notified of completion via webhooks.

{
  "ingestId": "1042",
  "releaseId": "DIST-2026-00123",
  "status": "processing",
  "receivedAt": "2026-08-06T10:38:00+09:00",
  "completedAt": null,
  "resources": { "total": 14, "completed": 0, "failed": 0 }
}

For a step-by-step walkthrough, see the Quickstart.

If you run into trouble while integrating, check the FAQ or reach out through our support channels.