MuzikHubDocs

MuzikHub Label API

The MuzikHub API allows you to programmatically manage artists, automate smart link creation, and retrieve detailed analytics. Integrate powerful label management directly into your existing tools and workflows.

Overview

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. The API is RESTful, uses standard HTTP verbs, and returns JSON-encoded responses.

Authentication

Authenticate your requests by including your secret API key in the Authorization header. You can manage your API keys in the developer dashboard. Do not share your secret API keys in publicly accessible areas such as GitHub or client-side code.

Header format
Authorization: Bearer mzh_xxxxxxxxxxxxxxxxxxxxxxxx

Rate Limits

Label API keys currently have unlimited requests with no strict rate limiting. However, we monitor usage and recommend implementing exponential backoff in your applications to ensure fair usage and prevent abuse.

Artists Endpoints

List All Artists

GET

Retrieve a paginated list of all artists managed by your label. The artists are sorted by creation date in descending order.

URL https://muzikhub.vercel.app/api/v1/artist
Example Request 
curl -X GET https://muzikhub.vercel.app/api/v1/artist \
  -H "Authorization: Bearer mzh_your_api_key"
Response 200 OK
{
  "success": true,
  "artists": [
    {
      "id": "art_12345",
      "artistName": "The Midnight Echo",
      "genre": "Synthwave",
      "verificationStatus": "verified",
      "createdAt": "2026-05-09T10:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1
  }
}

Create Artist

POST

Create a new artist account and automatically bind them to your label dashboard.

URL https://muzikhub.vercel.app/api/v1/artist

Request Body

artistName string Required

The display name of the artist.

slug string

The URL-friendly slug for the artist.

email string Required

The primary contact email for the artist account.

password string Required

Initial password for the artist.

genre string

Primary genre of the artist.

revenueSplitPercentage integer

Label revenue split percentage (0-100). Default is 50.

Example Request 
curl -X POST https://muzikhub.vercel.app/api/v1/artist \
  -H "Authorization: Bearer mzh_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "artistName": "Neon Dreams",
    "slug": "neon-dreams",
    "email": "hello@neondreams.com",
    "password": "securepassword123",
    "genre": "Electronic",
    "revenueSplitPercentage": 60
  }'
Response 200 OK
{
  "success": true,
  "artist": {
    "id": "art_67890",
    "artistName": "Neon Dreams",
    "email": "hello@neondreams.com",
    "genre": "Electronic",
    "relationshipType": "managed",
    "revenueSplitPercentage": 60,
    "createdAt": "2026-05-09T10:15:00Z"
  }
}

Get Artist

GET

Retrieve detailed profile information for a specific artist by their unique ID.

URL https://muzikhub.vercel.app/api/v1/artist/:id
Example Request 
curl -X GET https://muzikhub.vercel.app/api/v1/artist/art_67890 \
  -H "Authorization: Bearer mzh_your_api_key"
Response 200 OK
{
  "success": true,
  "artist": {
    "id": "art_67890",
    "artistName": "Neon Dreams",
    "bio": "Electronic duo from the future.",
    "genre": "Electronic",
    "socialLinks": {
      "spotify": "https://spotify.com/...",
      "instagram": "https://instagram.com/..."
    }
  }
}

Update Artist

PATCH

Update an existing artist's profile information. Only the fields provided in the request body will be updated.

URL https://muzikhub.vercel.app/api/v1/artist/:id

Request Body

artistName string

Update the display name.

bio string

Update the artist biography.

genre string

Update the primary genre.

Example Request 
curl -X PATCH https://muzikhub.vercel.app/api/v1/artist/art_67890 \
  -H "Authorization: Bearer mzh_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "bio": "Award-winning electronic duo."
  }'
Response 200 OK
{
  "success": true,
  "artist": {
    "id": "art_67890",
    "artistName": "Neon Dreams",
    "bio": "Award-winning electronic duo.",
    "genre": "Electronic"
  }
}

Delete Artist

DELETE

Permanently delete an artist and disconnect them from your label. This action cannot be undone.

URL https://muzikhub.vercel.app/api/v1/artist/:id
Example Request 
curl -X DELETE https://muzikhub.vercel.app/api/v1/artist/art_67890 \
  -H "Authorization: Bearer mzh_your_api_key"
Response 200 OK
{
  "success": true,
  "message": "Artist successfully deleted."
}

Smart Links Endpoints