> For the complete documentation index, see [llms.txt](https://docs.acrcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acrcloud.com/reference/identification-api/metadata/music.md). # Music ### JSON structure ```json { "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 } ], "rights_claim_policy": "monetize", "territories": [ "AD", "AE", "AF" ] }, { "distributor": { "id": "PADPIDA2007040502I", "name": "Sony Music Entertainment" }, "rights_owners": [ { "name": "Sony Music Entertainment", "share_percentage": 100 } ], "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" } }, "youtube": { "vid": "YQHsXMglC9A" } }, "score": 100, "genres": [ { "name": "Pop" } ], "release_date": "2015-10-23", "works": [ { "iswc": "T9178198088", "name": "HELLO", "creators": [ { "name": "KURSTIN GREGORY ALLEN", "last_name": "KURSTIN", "ipi": 122619891, "roles": [ "Composer" ] }, { "name": "ADKINS ADELE LAURIE BLUE", "last_name": "ADKINS", "ipi": 544476240, "roles": [ "Composer" ] }, { "name": "EMI APRIL MUSIC INC ", "last_name": "EMI APRIL MUSIC INC", "ipi": 128633767, "roles": [ "Publisher" ] }, { "name": "KURSTIN MUSIC ", "last_name": "KURSTIN MUSIC", "ipi": 485851707, "roles": [ "Publisher" ] }, { "name": "MELTED STONE PUBLISHING LTD ", "last_name": "MELTED STONE PUBLISHING LTD", "ipi": 676466696, "roles": [ "Publisher" ] } ] } ] } ] }, "status": { "msg": "Success", "version": "1.0", "code": 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 | | +roles | The roles of the creator | | time\_skew | Time skew refers to a temporal misalignment or timing offset between two audio signals. It means that the audio events (such as beats, notes, or spectral features) occur earlier or later in time than expected. | | frequency\_skew | Frequency skew refers to a distortion in the frequency domain, where the spectral components of the audio are shifted upward or downward in frequency. | {% hint style="info" %} **Please note: Only *****ACRID,*** ***Track Title, Artists Name, Album Name***** and \*\_time\_offset\_ms fields are required, other fields are optional.** \#fields are visible for the projects with copyright compliance option only. +fields are visible upon request, please contact us if you need those fields. {% endhint %}