Links

Music

Example of JSON result: music with ACRCloud Music bucket with Audio & Video Recognition

JSON structure

{
"metadata":{
"timestamp_utc":"2020-01-19 02:58:28",
"music":[
{
"db_begin_time_offset_ms":0,
"db_end_time_offset_ms":9280,
"sample_begin_time_offset_ms":0,
"sample_end_time_offset_ms":9280,
"play_offset_ms":9040,
"artists":[
{
"name":"Adele",
"langs":[{"code":"zh-Hans", "name":"阿黛尔"}]
}
],
"acrid":"6049f11da7095e8bb8266871d4a70873",
"album":{
"name":"Hello",
"langs":[{"code":"zh-Hans","name":"Hello"}]
},
"rights_claim": [
{"distributor":{"id":"PADPIDA2007050901U", "name":"Warner Music Group"},"rights_owners":[{"name":"Warner Music Group", "share_percentage":100.00}],"rights_claim_policy":"monetize", "territories":["AD","AE","AF"]},
{"distributor":{"id":"PADPIDA2007040502I", "name":"Sony Music Entertainment"}, "rights_owners":[{"name":"Sony Music Entertainment", "share_percentage":100.00}],"territories":["AB","AC"]}
],
"external_ids":{
"iswc":"T9178198088",
"isrc":"GBBKS1500214",
"upc":"886445581959"
},
"result_from":3,
"contributors":{
"composers":[
"Adele Adkins",
"Greg Kurstin"
],
"lyricists":[
"ADELE ADKINS",
"GREGORY KURSTIN"
]
},
"title":"Hello",
"langs":[{"code":"zh-Hans","name":"Hello"}]
"language":"en",
"duration_ms":295000,
"label":"XL Recording",
"external_metadata":{
"musicbrainz":{
"track":{
"id":"0a8e8d55-4b83-4f8a-9732-fbb5ded9f344"
}
},
"deezer":{
"track":{
"id":"110265034"
},
"artists":[
{
"id":"75798"
}
],
"album":{
"id":"11483764"
}
},
"spotify":{
"track":{
"id":"4aebBr4JAihzJQR0CiIZJv"
},
"artists":[
{
"id":"4dpARuHxo51G3z768sgnrY"
}
],
"album":{
"id":"7uwTHXmFa1Ebi5flqBosig"
}
},
"musicstory":{
"track":{
"id":"13106540"
},
"album":{
"id":"931271"
}
},
"youtube":{
"vid":"YQHsXMglC9A"
}
},
"score":100,
"genres":[{"name":"Pop"}],
"release_date":"2015-10-23"
"release_by_territories": [
{"territories": ["DK"], "release_date": "2006-04-17"},
{"territories": ["JP"], "release_date": "2006-10-17"},
{"territories": ["SE"], "release_date": "2005-06-21"},
{"exclude_territories":["CN"], "territories": ["BG", "AL", "BA", "CZ", "EE", "HR", "HU", "LT", "LV", "MK", "ME", "PL", "RO", "RS", "SI", "SK", "UA"], "release_date": "2006-03-24"},
{"territories": ["GB", "IE", "NZ"], "release_date": "2005-07-18"},
{"territories": ["FR"], "release_date": "2005-07-26"}
],
"works":[
{
"iswc":"T9178198088",
"name":"HELLO",
"creators":[
{"name":"KURSTIN GREGORY ALLEN","ipi":122619891},
{"name":"ADKINS ADELE LAURIE BLUE","ipi":544476240},
]
}
],
]
},
"status":{
"msg":"Success",
"version":"1.0",
"code":0
},
"result_type":0
}

Metadata fields

Name
Description
music
Music fields
acrid
ACRCloud unique identifier
timestamp_utc
Server time of sending results, Timestamp of the song started for custom monitoring, UTC time zone
title
Track title
album
Album fields
id
Identifier of the artists , album or 3rd parties fields
name
Name of the artists or album
artists
Artists fields
duration_ms
Duration of the track in millisecond
play_offset_ms
The time position of the audio/song being played (millisecond)
external_ids
External standard code
isrc
ISRC code
upc
UPC code
external_metadata
External 3rd party IDs and metadata
track
Track fields
genres
Genres fields
label
Music label name
release_date
Release data of the track, format:YYYY-MM-DD
spotify
Spotify fields
deezer
Deezer fields
lyricfind
LyricFind fields
lfid
LyricsFind's lyric ID
youtube
YouTube fields
vid
Youtube video ID
musicbrainz
MusicBrainz Identifier - MBID
*db_begin_time_offset_ms
Position of beginning of the recognition on database file (millisecond)
*db_end_time_offset_ms
Position of end of the recognition on database file (millisecond)
*sample_begin_time_offset_ms
Position of beginning of the recognition in sample file sent by SDK/API (millisecond)
*sample_end_time_offset_ms
Position of end of the recognition in sample file sent by SDK/API (millisecond)
*played_duration
Actual duration of the track played in the streams for Broadcast Monitoring service, in second
score
Match confidence score. Range: 70 - 100
+contributors
Contributor information for this track
+composers
Composers of the song
+lyricists
Writers of the lyrics
language
Language of the song, ISO 639-1 codes
langs
Translation into different languages. Example: [{"code":"ru", "name":"Я твой враг"}]
#rights_claim
All relevant metadata fields to determine rights owners, available territories and rights claim policy for UGC platforms. These metadata fields are for copyright compliance users only.
#distributor
Information of distributor for this track
#id
DDEX Party ID of the distributor, this ID won't change.
#name
Name of the distributor, This name might be changing from time to time.
#rights_claim_policy
Right policy for UGC platforms, the value options are "Monetize", "Allow", "ReportUsage" and "BlockAccess".
#rights_owners
Rights owners' name, example: [{"name":"Warner Music Group", "share_percentage":100}]
#territories
Territory codes for Included territories, ISO country codes applied.
#excluded_territories
Territory codes for excluded territories, ISO country codes applied.
#share_percentage
Percentage of the rights share for each rights owners.
#release_by_territories
Release details by territories, indicate the release date for territories.
+work
Publishing metadata fields for works
+ISWC
ISWC code
+name
Name of the work
+creators
The creators of the work
+ipi
IPI code for the creator
Please note: Only ACRID, Track Title, Artists Name and Album Name fields are required, other fields are optional.
* fields are visible in Broadcast Monitoring service only, if you want to use these fields in recognition service, please contact us.
#fields are visible for the projects with copyright compliance option only.
+fields are visible upon request, please contact us if you need those fields.