Using REST API for Automated Distribution

REST API Guide

For developers and power users, Mcarthur Records provides a comprehensive REST API for automating distribution workflows.

API Overview

• RESTful architecture
• JSON responses
• OAuth 2.0 authentication
• Rate limiting (1000 requests/hour)
• Webhook support

Key Endpoints

• POST /api/release: Create and submit a release
• GET /api/release/{id}: Get release status
• PUT /api/release/{id}: Update release metadata
• GET /api/analytics: Get streaming analytics
• GET /api/royalties: Get royalty reports

Authentication

GET /api/release
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
            

Example: Create a Release

POST /api/release
{
    "title": "My New Single",
    "artist": "My Artist Name",
    "release_date": "2024-12-01",
    "tracks": [
        {
            "title": "Track 1",
            "audio_url": "https://storage.mcarthur.com/track1.wav",
            "isrc": "US-ABC-12-34567"
        }
    ],
    "artwork_url": "https://storage.mcarthur.com/artwork.jpg"
}