Metadata API

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 this page.

Query Parameters

NameTypeDescription

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

NameTypeDescription

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)

Last updated