Skip to main content

​
Welcome

The Blurb API enables you to programmatically generate and manage media content. This API provides endpoints for creating and managing artists, media bundles (albums), individual media (songs), and batch content generation.

​
Authentication

All API endpoints require authentication using Bearer tokens. Include your API token in the Authorization header: 
Authorization: Bearer <your_token>

​
Base URL

All API requests should be made to: 
https://api.blurb.fail

​
Core Concepts

​
Artists

Artists represent the creators of content. Each artist can have:
  • Basic information (name, image)
  • External IDs (Spotify, Apple Music, YouTube)
  • Client reference IDs

​
Media Bundles

Media bundles represent collections like albums. They include:
  • Association with an artist
  • Album artwork
  • UPC (Universal Product Code)
  • External platform IDs

​
Media

Individual media items (like songs) that belong to a media bundle. They contain:
  • Audio files (main track and instrumental)
  • Video assets in various aspect ratios
  • ISRC codes
  • Lyrics and other text assets
  • Platform-specific IDs and URLs

​
Batches

Batches allow you to generate content for media items. You can:
  • Generate multiple renders per batch
  • Specify video settings (aspect ratio, quality, file name)
  • Configure service parameters (language, colors, segments)
  • Set webhooks for status updates

​
Webhooks

Webhooks are used to receive notifications about events in the Blurb API such as status updates, progress, completionand errors.

​
Response Format

All API responses follow a standard format: For successful requests: 
{
  "success": true,
  "message": "Success message",
  "data": {
    // Response data specific to the endpoint
    ...
  }
}
For errors: 
{
  "success": false,
  "message": "Error message",
  "data": {
    // Error details
    ...
  }
}

​
Support

If you need assistance, contact us at [email protected].

​
Request Parameters

  • ref - A reference string for the batch. This will be passed through to the webhook.
  • webhookUrl - URL to receive status updates.
  • audioUrl - URL for audio files. Must be a valid mp3 file.
  • artworkUrl - URL for artwork images. Must be 1:1 aspect ratio and .png or .jpg format.