Partner API v1

JewelMusic API Reference

Complete documentation for all JewelMusic API endpoints

Base URL
All API requests should be made to:
https://api.jewelmusic.art/v1
Authentication
Authenticate requests using your API key in the Authorization header
Authorization: Bearer jml_live_your_api_key_here

API Endpoints

POST /v1/transcription
AI-powered music transcription with 99.7% accuracy
Professional

Request Body:

{
  "audio_url": "https://example.com/song.mp3",
  "languages": ["en", "ka", "es"],
  "include_timestamps": true,
  "format": "json"
}

Response:

{
  "transcription_id": "tr_1234567890",
  "status": "completed",
  "lyrics": [
    {
      "timestamp": 0,
      "text": "First line of lyrics",
      "language": "en"
    }
  ],
  "confidence": 0.997
}
POST /v1/analysis
Deep musical analysis including tempo, key, and cultural patterns
Professional

Request Body:

{
  "track_id": "trk_1234567890",
  "analysis_types": [
    "tempo",
    "key",
    "structure",
    "cultural_patterns",
    "mood"
  ]
}

Response:

{
  "analysis_id": "an_1234567890",
  "tempo": 120,
  "key": "C major",
  "time_signature": "4/4",
  "structure": {
    "intro": "0:00-0:15",
    "verse": "0:15-1:00",
    "chorus": "1:00-1:30"
  },
  "cultural_classification": {
    "primary": "Georgian Polyphonic",
    "confidence": 0.92
  },
  "mood": ["uplifting", "traditional"]
}
POST /v1/distribution
Distribute music to 150+ streaming platforms
Enterprise

Request Body:

{
  "release_id": "rel_1234567890",
  "platforms": [
    "spotify",
    "apple_music",
    "youtube_music",
    "tidal",
    "deezer"
  ],
  "territories": ["worldwide"],
  "release_date": "2025-09-01T00:00:00Z",
  "pricing_tier": "standard"
}
GET /v1/royalties
Real-time royalty tracking and reporting
Professional

Query Parameters:

?start_date=2025-01-01&end_date=2025-08-31&platform=all

Response:

{
  "total_revenue": 1234.56,
  "currency": "USD",
  "period": {
    "start": "2025-01-01",
    "end": "2025-08-31"
  },
  "breakdown": [
    {
      "platform": "spotify",
      "streams": 45678,
      "revenue": 456.78
    }
  ]
}
Rate Limits
API rate limits vary by subscription tier

Starter

100 requests/hour

Professional

1,000 requests/hour

Enterprise

Unlimited

Error Codes
Standard HTTP status codes and custom error responses
200Success
401Authentication required
403Access restricted (tier limitation)
404Endpoint not found
429Rate limit exceeded
500Internal server error

Ready to Start Building?

Apply for partner access and get your API keys today