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
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)
Successful analysis with cleared content
{
"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)
Missing URL parameter
{
"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)
Missing API key header
{
"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
}