ACRCloud
Search…
Get Started
SDK REFERENCE
API Reference
Tools
Music
Example of JSON result: music with ACRCloud Music bucket with Audio & Video Recognition
JSON structure
1
{
2
"metadata":{
3
"timestamp_utc":"2020-01-19 02:58:28",
4
"music":[
5
{
6
"db_begin_time_offset_ms":0,
7
"db_end_time_offset_ms":9280,
8
"sample_begin_time_offset_ms":0,
9
"sample_end_time_offset_ms":9280,
10
"play_offset_ms":9040,
11
"artists":[
12
{
13
"name":"Adele",
14
"langs":[{"code":"zh-Hans", "name":"阿黛尔"}]
15
}
16
],
17
"acrid":"6049f11da7095e8bb8266871d4a70873",
18
"album":{
19
"name":"Hello",
20
"langs":[{"code":"zh-Hans","name":"Hello"}]
21
},
22
"rights_claim": [
23
{"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"]},
24
{"distributor":{"id":"PADPIDA2007040502I", "name":"Sony Music Entertainment"}, "rights_owners":[{"name":"Sony Music Entertainment", "share_percentage":100.00}],"territories":["AB","AC"]}
25
],
26
"external_ids":{
27
"iswc":"T9178198088",
28
"isrc":"GBBKS1500214",
29
"upc":"886445581959"
30
},
31
"result_from":3,
32
"contributors":{
33
"composers":[
34
"Adele Adkins",
35
"Greg Kurstin"
36
],
37
"lyricists":[
38
"ADELE ADKINS",
39
"GREGORY KURSTIN"
40
]
41
},
42
"title":"Hello",
43
"langs":[{"code":"zh-Hans","name":"Hello"}]
44
"language":"en",
45
"duration_ms":295000,
46
"label":"XL Recording",
47
"external_metadata":{
48
"musicbrainz":{
49
"track":{
50
"id":"0a8e8d55-4b83-4f8a-9732-fbb5ded9f344"
51
}
52
},
53
"deezer":{
54
"track":{
55
"id":"110265034"
56
},
57
"artists":[
58
{
59
"id":"75798"
60
}
61
],
62
"album":{
63
"id":"11483764"
64
}
65
},
66
"spotify":{
67
"track":{
68
"id":"4aebBr4JAihzJQR0CiIZJv"
69
},
70
"artists":[
71
{
72
"id":"4dpARuHxo51G3z768sgnrY"
73
}
74
],
75
"album":{
76
"id":"7uwTHXmFa1Ebi5flqBosig"
77
}
78
},
79
"musicstory":{
80
"track":{
81
"id":"13106540"
82
},
83
"album":{
84
"id":"931271"
85
}
86
},
87
"youtube":{
88
"vid":"YQHsXMglC9A"
89
}
90
},
91
"score":100,
92
"genres":[{"name":"Pop"}],
93
"release_date":"2015-10-23"
94
"release_by_territories": [
95
{"territories": ["DK"], "release_date": "2006-04-17"},
96
{"territories": ["JP"], "release_date": "2006-10-17"},
97
{"territories": ["SE"], "release_date": "2005-06-21"},
98
{"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"},
99
{"territories": ["GB", "IE", "NZ"], "release_date": "2005-07-18"},
100
{"territories": ["FR"], "release_date": "2005-07-26"}
101
],
102
"works":[
103
{
104
"iswc":"T9178198088",
105
"name":"HELLO",
106
"creators":[
107
{"name":"KURSTIN GREGORY ALLEN","ipi":122619891},
108
{"name":"ADKINS ADELE LAURIE BLUE","ipi":544476240},
109
]
110
}
111
],
112
​
113
]
114
},
115
"status":{
116
"msg":"Success",
117
"version":"1.0",
118
"code":0
119
},
120
"result_type":0
121
}
Copied!
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
iswc
ISWC - International Standard Musical Work Code
*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.
Last modified 3mo ago
Copy link