Preventing Copyright Claims for Songs Used in YouTube Videos

⚠️

Important Information

• Codes generated must be added to the video description at the time of upload for content claims to be released.
• Codes are single use and will clear only one song.
• One code per song is needed to clear a video with multiple songs.
• The video will not have monetization claims removed if the code was not input into the description at the time of upload.

Overview

When using Soundstripe music in your YouTube videos, you (or your client) may receive Content ID claims. These claims occur when YouTube's automated system detects Soundstripe music in your content. This document outlines how to prevent these claims from preventing monetization issues.

If you're generating these codes on behalf of a client be sure to provide them with the code to be used in the description at the time of upload, or the content claims will not be removed.

Requirements

• A valid Soundstripe API Key
• The song_id of a song used in the video

Making the API request

To generate a release code, you'll need to make a POST request to the digital usages endpoint. This endpoint creates a unique code that can be used to clear Content ID claims for a specific song.

Endpoint Details

POST /v1/songs/{song_id}/digital_usages

The endpoint requires proper authentication and specific headers to function correctly. Here's what you need:

Authentication

All requests must include your API key as a Token with the Authorization header:

Authorization: Token YOUR_API_KEY

Required Headers
The API expects and responds with JSON:API formatted data:

Content-Type: application/vnd.api+json  
Accept: application/vnd.api+json

Request Structure

The request body must follow the JSON:API specification and include the correct type:

{
  "data": {
    "type": "digital_usages"
  }
}

Response Format

When successful, the API will return a response containing your YouTube release code:

{
  "data": {
    "id": "1",
    "type": "digital_usages",
    "attributes": {
      "youtube_code": "<your_youtube_code>"
    }
  }
}

Making the request

For example, here's how to make the request using cURL. Be sure to replace the song_id and your Authorization Token.

curl -X POST \
  "https://api.soundstripe.com/v1/songs/SONG_ID/digital_usages" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "digital_usages"
    }
  }'

Add the code to the YouTube description

Lastly, the client will need to add this code to the YouTube description at the time of upload for claims to be released.

Use one code per song, and create codes for each song used if you use multiple in one video. Codes are one-time usage only.