POST /clear

Analyzes an audio file from a publicly accessible URL to detect:

  • Released vs unreleased songs
  • Major label copyright risks
  • Content ID risks
  • Song metadata and listening links
application/json

Body Required

  • url string(uri) Required

    Publicly accessible URL of the audio file to analyze

Responses

  • 200 application/json

    Successful audio analysis

    Hide response attributes Show response attributes object
    • success boolean Required

      Indicates if the operation was successful

    • result object
      Hide result attributes Show result attributes object
      • release_status string Required

        Overall release status of detected songs

        Values are released or not_released.

      • released_songs array[object] Required

        List of songs that have been officially released

        Hide released_songs attributes Show released_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • major_label_risk string Required

        Risk level for major label copyright claims

        Values are at_risk or no_risk.

      • major_label_songs array[object] Required

        Songs from major labels that pose copyright risk

        Hide major_label_songs attributes Show major_label_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • content_id_risk string Required

        Risk level for Content ID claims

        Values are at_risk or no_risk.

      • content_id_songs array[object] Required

        Songs that may trigger Content ID claims

        Hide content_id_songs attributes Show content_id_songs attributes object
        • artist string Required

          Artist name

        • title string Required

          Song title

        • album string

          Album name

        • release_date string(date)

          Release date of the song

        • label string

          Record label

        • timecode string Required

          Time position in the audio where this song was detected

          Format should match the following pattern: ^\d{2}:\d{2}$.

        • isrc string

          International Standard Recording Code

        • upc string

          Universal Product Code

        • album_image_url string(uri)

          Album cover image URL

        • duration_ms integer

          Song duration in milliseconds

      • originalFileName string

        Original filename of the analyzed audio

    • resultId string(uuid)

      Unique identifier for this analysis result

    • error string

      Error type if the operation failed

    • message string

      Human-readable message about the operation result

  • 400 application/json

    Bad request - Invalid input

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

  • 401 application/json

    Unauthorized - Missing or invalid API key

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • success boolean Required

      Always false for error responses

    • error string Required

      Error type or category

    • message string Required

      Human-readable error message

POST /clear
curl \
 --request POST 'https://api.clearedmusic.io/clear' \
 --header "x-api-key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"url":"https://example.com/audio/sample.mp3"}'
Request example
{
  "url": "https://example.com/audio/sample.mp3"
}
Response examples (200)
{
  "result": {
    "release_status": "released",
    "released_songs": [
      {
        "upc": "123456789012",
        "isrc": "USRC12345678",
        "album": "Example Album",
        "label": "Independent Label",
        "title": "Example Song",
        "artist": "Example Artist",
        "timecode": "00:30",
        "duration_ms": 180000,
        "listen_links": [
          {
            "url": "https://open.spotify.com/track/abc123",
            "service": "spotify"
          },
          {
            "url": "https://music.apple.com/song/123",
            "service": "apple"
          }
        ],
        "release_date": "2023-01-15",
        "album_image_url": "https://i.scdn.co/image/ab67616d0000b273abc123"
      }
    ],
    "content_id_risk": "no_risk",
    "content_id_songs": [],
    "major_label_risk": "no_risk",
    "originalFileName": "sample.mp3",
    "major_label_songs": []
  },
  "success": true,
  "resultId": "550e8400-e29b-41d4-a716-446655440000"
}
{
  "result": {
    "release_status": "released",
    "released_songs": [
      {
        "upc": "987654321098",
        "isrc": "USUM71234567",
        "album": "Popular Album",
        "label": "Universal Music Group",
        "title": "Hit Song",
        "artist": "Major Label Artist",
        "timecode": "01:15",
        "release_date": "2023-06-01"
      }
    ],
    "content_id_risk": "at_risk",
    "content_id_songs": [
      {
        "album": "Popular Album",
        "label": "Universal Music Group",
        "title": "Hit Song",
        "artist": "Major Label Artist",
        "timecode": "01:15",
        "release_date": "2023-06-01"
      }
    ],
    "major_label_risk": "at_risk",
    "major_label_songs": [
      {
        "album": "Popular Album",
        "label": "Universal Music Group",
        "title": "Hit Song",
        "artist": "Major Label Artist",
        "timecode": "01:15",
        "release_date": "2023-06-01"
      }
    ]
  },
  "success": true,
  "resultId": "550e8400-e29b-41d4-a716-446655440001"
}
Response examples (400)
{
  "error": "Missing required parameter: url",
  "message": "The url parameter is required",
  "success": false
}
{
  "error": "Invalid URL format",
  "message": "The provided URL is not valid",
  "success": false
}
{
  "error": "Invalid JSON in request body",
  "message": "Request body must be valid JSON",
  "success": false
}
Response examples (401)
{
  "error": "Missing authentication",
  "message": "The x-api-key header is required",
  "success": false
}
{
  "error": "Invalid authentication",
  "message": "The provided API key is invalid",
  "success": false
}
Response examples (500)
{
  "error": "Audio analysis failed",
  "message": "An error occurred while analyzing the audio file",
  "success": false
}