ACRCloud
Visit WebsiteConsole
  • Introduction
  • Get Started
  • Console Tutorials
    • Recognize Music
    • Recognize Custom Content
    • Broadcast Monitoring for Music
    • Broadcast Monitoring for Custom Content
    • Detect Live & Timeshift TV Channels
    • Recognize Custom Content Offline
    • Recognize Live Channels and Custom Content
    • Find Potential Detections in Unknown Content Filter
  • SDK REFERENCE
    • Mobile SDK
      • iOS
      • Android
      • Unity
    • Backend SDK
      • Python
      • PHP
      • Go
      • Java
      • C/C++
      • C#
    • Error Codes
  • API Reference
    • Identification API
    • Console API
      • Access Token
      • Buckets
        • Audio Files
        • Live Channels
        • Dedup Files
      • Base Projects
      • OfflineDBs
      • BM Projects
        • Custom Streams Projects
          • Streams
          • Streams Results
          • Streams State
          • Recordings
          • Analytics
          • User Reports
        • Broadcast Database Projects
          • Channels
          • Channels Results
          • Channels State
          • Recordings
          • Analytics
          • User Reports
      • File Scanning
        • FsFiles
      • UCF Projects
        • BM Streams
        • UCF Results
    • Metadata API
  • Tools
    • Audio File Fingerprinting Tool
    • Local Monitoring Tool
    • Live Channel Fingerprinting Tool
    • File Scan Tool
  • Metadata
    • Music
    • Music (Broadcast Monitoring with Broadcast Database)
    • Custom Files
    • Live Channels
    • Humming
  • FAQ
    • Definition of Terms
  • Service Usage
Powered by GitBook
On this page
  1. API Reference

Metadata API

Last updated 1 year ago

Get music platforms metadata and links

GET https://eu-api-v2.acrcloud.com/api/external-metadata/tracks

You can get metadata and links from the platforms(Spotify, Apple Music, Youtube, Deezer, Tidal, Gaana, AWA, KKBOX, MusicBrainz)

You can test on .

Query Parameters

Name
Type
Description

source_url

String

isrc

String

ISRC

acr_id

String

ACRCloud Music ID

platforms

String

The platform's metadata you want to get. for example: spotify,youtube The default value is: spotify,deezer,youtube,applemusic The number of platforms in the platforms parameter of a single request cannot exceed 5.

query

String

Your search query, text format example: Eminem - Without Me json format example( need to stringify the json data): {"track":"Without Me", "artists":["Eminem"]}

include_works

Number

1 or 0, if you set it to 1, the response metadata will contain the contributors and works metadata if the tracks have

format

String

query string format, text or json. Default value is text

Headers

Name
Type
Description

Authorization*

String

{
  "data": [
      {
          "name": "Blank Space",
          "disc_number": 1,
          "track_number": 6,
          "isrc": "USCJY1431309",
          "genres": [
              "Pop",
              "Music"
          ],
          "duration_ms": 230760,
          "release_date": "2014-01-01",
          "artists": [
              {
                  "name": "Taylor Swift"
              }
          ],
          "album": {
              "track_count": 20,
              "upc": "00602577145735",
              "release_date": "2018-10-26",
              "label": "NOW20thAnniversary",
              "cover": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/3000x3000bb.jpg",
              "covers": {
                  "small": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/64x64bb.jpg",
                  "medium": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/300x300bb.jpg",
                  "large": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/3000x3000bb.jpg"
              }
          },
          "external_metadata": {
              "applemusic": [
                  {
                      "id": "1437689373",
                      "link": "https://music.apple.com/us/album/blank-space/1437689355?i=1437689373",
                      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview112/v4/b7/20/d4/b720d476-169f-d94e-1bed-7d91d43f2883/mzaf_12311605322954569753.plus.aac.p.m4a",
                      "artists": [
                          {
                              "id": "159260351"
                          }
                      ],
                      "album": {
                          "id": "1437689355",
                          "cover": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/3000x3000bb.jpg"
                      }
                  },
                  {
                      "id": "1440933517",
                      "link": "https://music.apple.com/us/album/blank-space/1440933512?i=1440933517",
                      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview115/v4/81/bf/3d/81bf3ddc-75c0-46a3-d85b-9e79f0641a41/mzaf_2416740226777406648.plus.aac.p.m4a",
                      "artists": [
                          {
                              "id": "159260351"
                          }
                      ],
                      "album": {
                          "id": "1440933512",
                          "cover": "https://is2-ssl.mzstatic.com/image/thumb/Music124/v4/54/45/87/544587c8-3f71-8484-3fdb-186a7d7b7326/00843930013609.rgb.jpg/2400x2400bb.jpg"
                      }
                  },
                  {
                      "id": "1445765740",
                      "link": "https://music.apple.com/us/album/blank-space/1445765736?i=1445765740",
                      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview115/v4/20/3b/f8/203bf8a6-4f53-8e6b-ec00-8afd01241ebe/mzaf_2559055475772421277.plus.aac.p.m4a",
                      "artists": [
                          {
                              "id": "159260351"
                          }
                      ],
                      "album": {
                          "id": "1445765736",
                          "cover": "https://is5-ssl.mzstatic.com/image/thumb/Music124/v4/b2/38/d3/b238d354-1aec-f71b-8706-26fcb1738b6d/00843930039562.rgb.jpg/3000x3000bb.jpg"
                      }
                  }
              ],
              "deezer": [
                  {
                      "id": "89077521",
                      "link": "https://www.deezer.com/track/89077521",
                      "artists": [
                          {
                              "id": 12246
                          }
                      ],
                      "album": {
                          "id": 9007779,
                          "cover": "https://api.deezer.com/2.0/album/9007779/image"
                      }
                  }
              ],
              "youtube": [
                  {
                      "id": "dC9QIUKviJU",
                      "link": "https://music.youtube.com/watch?v=dC9QIUKviJU",
                      "artists": [
                          {
                              "id": "UCPC0L1d253x-KuMNwa05TpA",
                              "link": "https://music.youtube.com/channel/UCPC0L1d253x-KuMNwa05TpA"
                          }
                      ],
                      "album": {
                          "id": "MPREb_JiAQrbUtBdP",
                          "link": "https://music.youtube.com/browse/MPREb_JiAQrbUtBdP"
                      }
                  },
                  {
                      "id": "uakZpnmQGiE",
                      "link": "https://music.youtube.com/watch?v=uakZpnmQGiE",
                      "artists": [
                          {
                              "id": "UCPC0L1d253x-KuMNwa05TpA",
                              "link": "https://music.youtube.com/channel/UCPC0L1d253x-KuMNwa05TpA"
                          }
                      ],
                      "album": {
                          "id": "MPREb_FqCrQJ3iwcD",
                          "link": "https://music.youtube.com/browse/MPREb_FqCrQJ3iwcD"
                      }
                  },
                  {
                      "id": "QIfZAPkF7_M",
                      "link": "https://music.youtube.com/watch?v=QIfZAPkF7_M",
                      "artists": [
                          {
                              "id": "UCbhKnJtOmuOuaoY5hGwtYgA",
                              "link": "https://music.youtube.com/channel/UCbhKnJtOmuOuaoY5hGwtYgA"
                          }
                      ],
                      "album": {
                          "id": "MPREb_jucl3t8hdEz",
                          "link": "https://music.youtube.com/browse/MPREb_jucl3t8hdEz"
                      }
                  }
              ],
              "spotify": [
                  {
                      "id": "1437689373",
                      "link": "https://music.apple.com/us/album/blank-space/1437689355?i=1437689373",
                      "preview": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview112/v4/b7/20/d4/b720d476-169f-d94e-1bed-7d91d43f2883/mzaf_12311605322954569753.plus.aac.p.m4a",
                      "artists": [
                          {
                              "id": "159260351"
                          }
                      ],
                      "album": {
                          "id": "1437689355",
                          "cover": "https://is3-ssl.mzstatic.com/image/thumb/Music124/v4/0b/ae/32/0bae3256-7bb0-82f9-35f8-bca634c4aae8/18UMGIM62497.rgb.jpg/3000x3000bb.jpg"
                      }
                  }
              ]
          },
          "type": "track",
          "works": [
              {
                  "iswc": "T9155554271",
                  "contributors": [
                      {
                          "name": "MAX MARTIN",
                          "ipi": 254380962,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SHELLBACK ",
                          "ipi": 583608328,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SWIFT TAYLOR ALISON",
                          "ipi": 454808047,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SONY/ATV TREE PUBLISHING ",
                          "ipi": 425389934,
                          "roles": [
                              "Publisher"
                          ]
                      },
                      {
                          "name": "TAYLOR SWIFT MUSIC ",
                          "ipi": 497322918,
                          "roles": [
                              "Publisher"
                          ]
                      }
                  ],
                  "name": "BLANK SPACE VOICE MEMO"
              },
              {
                  "iswc": "T9156975165",
                  "contributors": [
                      {
                          "name": "MAX MARTIN",
                          "ipi": 254380962,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SHELLBACK ",
                          "ipi": 583608328,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SWIFT TAYLOR ALISON",
                          "ipi": 454808047,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "MXM MUSIC AB ",
                          "ipi": 657349509,
                          "roles": [
                              "Publisher"
                          ]
                      },
                      {
                          "name": "SONY/ATV TREE PUBLISHING ",
                          "ipi": 425389934,
                          "roles": [
                              "Publisher"
                          ]
                      },
                      {
                          "name": "KMR MUSIC ROYALTIES II SCSP ",
                          "ipi": 858735976,
                          "roles": [
                              "Publisher"
                          ]
                      },
                      {
                          "name": "TAYLOR SWIFT MUSIC ",
                          "ipi": 497322918,
                          "roles": [
                              "Publisher"
                          ]
                      }
                  ],
                  "name": "BLANK SPACE VOICE MEMO"
              },
              {
                  "iswc": "T9236690770",
                  "contributors": [
                      {
                          "name": "MAX MARTIN",
                          "ipi": 254380962,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SCHUSTER JOHAN KARL",
                          "ipi": 444712759,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "SWIFT TAYLOR ALISON",
                          "ipi": 454808047,
                          "roles": [
                              "Composer"
                          ]
                      },
                      {
                          "name": "PAYAMI ALI",
                          "ipi": 473985994,
                          "roles": [
                              "Composer"
                          ]
                      }
                  ],
                  "name": "BLANK SPACE/STYLE"
              }
          ]
      }
  ]
}

import requests

url = "https://eu-api-v2.acrcloud.com/api/external-metadata/tracks"
payload={}
headers = {
  'Authorization': 'Bearer your token'
}
params = {
   'query':json.dumps({"track": "jus sayin", "artists": ["steve lawler","Dateless"]}),
   'format':'json'
}
response = requests.get(url, headers=headers, params=params)

print(response.text)

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://eu-api-v2.acrcloud.com/api/external-metadata/tracks',
  params: {
    query:JSON.stringify({"track": "jus sayin", "artists": ["steve lawler", "Dateless"]}),
    format:'json'
  },
  headers: { 
    'Authorization': 'Bearer YOUR_TOKEN'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

the platform's url, for example::

Bearer token.

this page
https://www.youtube.com/watch?v=5UMCrq-bBCg
https://open.spotify.com/track/1p80LdxRV74UKvL8gnD7ky
https://www.deezer.com/track/1290892992
How to create the token