Skip to main content
POST
/
media
Create new media
curl --request POST \
  --url https://api.blurb.fm/v1/media \
  --header 'Content-Type: application/json' \
  --data '
{
  "mediaBundleId": "album_123",
  "name": "My Song",
  "plainTextLyrics": "The plain text lyrics of the media.",
  "language": "en",
  "isrc": "USRC17607839",
  "trackVersion": "Live",
  "trackNumber": 1,
  "discNumber": 1,
  "audioUrl": "https://storage.googleapis.com/my-bucket/song.mp3",
  "videoUrls": [
    "https://storage.googleapis.com/my-bucket/video-1.mp4",
    "https://storage.googleapis.com/my-bucket/video-2.mp4"
  ],
  "youtubeUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "spotifyUrl": "https://open.spotify.com/track/1234567890",
  "appleMusicUrl": "https://music.apple.com/us/album/1234567890"
}
'
{
  "success": true,
  "message": "Media created",
  "data": {
    "mediaId": "example",
    "name": "example"
  }
}

Body

application/json

The request to create media.

mediaBundleId
string
required

The ID of the media bundle.

Example:

"1234567890"

name
string
required

The name of the media.

Example:

"My Song"

plainTextLyrics
string | null

The plain text lyrics of the media.

Example:

"The plain text lyrics of the media."

language
enum<string> | null

The language of the media.

Available options:
en,
hi,
zh,
es,
pt,
fr,
ja,
de
Example:

"en"

isrc
string
default:""

The ISRC of the media.

Example:

"US-1234567890"

trackVersion
string | null
default:""

The track version of the media. e.g. Live, Acoustic, etc.

Example:

"Live"

trackNumber
number | null

The track number of the media. e.g. 1, 2, 3, etc.

Example:

1

discNumber
number | null

The disc number of the media. e.g. 1, 2, 3, etc.

Example:

1

imageUrl
string

The URL of the image asset.

Example:

"https://placehold.co/1000x1000"

audioUrl
string

The URL of the audio asset.

Example:

"https://placehold.co/1000x1000"

videoUrls
string[]

The URLs of the video assets.

Example:
[
"https://placehold.co/1000x1000",
"https://placehold.co/1000x1000"
]
instrumentalAudioUrl
string

The URL of the instrumental audio asset.

Example:

"https://placehold.co/1000x1000"

youtubeUrl
string

The URL of the YouTube asset.

Example:

"https://www.youtube.com/watch?v=dQw4w9WgXcQ"

spotifyUrl
string

The URL of the Spotify asset.

Example:

"https://open.spotify.com/track/1234567890"

appleMusicUrl
string

The URL of the Apple Music asset.

Example:

"https://music.apple.com/us/album/1234567890"

clientRef
string
default:""

The client reference for the media

Example:

"1234567890"

Response

Media created successfully

success
boolean
required

Whether the request was successful

Example:

true

message
string | null
required

Message from the API

Example:

"Media created"

data
object
required

The response from the Media POST request.

Example:
{ "mediaId": "example", "name": "example" }