Spotify 曲目匹配 API

API ID 13548

识别音频文件中的歌曲并返回有关曲目 艺术家 专辑 风格和音乐服务的详细信息

API 文档

端点

请求
识别上传音频文件中的歌曲,并返回匹配的曲目信息、艺术家信息、元数据、艺术作品和音乐服务链接
Endpoint ID: 30088
POST https://docs.zylalabs.com/api/13548/spotify+track+match+api/30088/track
输入参数

轨道 — 端点功能

对象 描述
请求体 必需 文件二进制

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "status": true,
    "result": {
        "matches": [
            {
                "id": "268047914",
                "offset": 122.574265625,
                "timeskew": -0.0003425479,
                "frequencyskew": -0.00020134449
            },
            {
                "id": "220246134",
                "offset": 122.25221875,
                "timeskew": -0.0021221042,
                "frequencyskew": -0.0015694499
            },
            {
                "id": "231707507",
                "offset": 122.36405468699999,
                "timeskew": -0.0020192862,
                "frequencyskew": -0.0017704964
            },
            {
                "id": "5883266",
                "offset": 122.534296875,
                "timeskew": -0.00038582087,
                "frequencyskew": -0.00016111135
            },
            {
                "id": "5940262",
                "offset": 113.90078125,
                "timeskew": -0.00046002865,
                "frequencyskew": 0
            }
        ],
        "location": {
            "accuracy": 0.01
        },
        "timestamp": 614101222,
        "timezone": "Europe/Moscow",
        "track": {
            "layout": "5",
            "type": "MUSIC",
            "key": "239201",
            "title": "Enjoy the Silence",
            "subtitle": "Depeche Mode",
            "images": {
                "background": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages112/v4/82/64/c0/8264c0fd-982c-39f5-9d9c-107a770d9854/d8732264-4180-4cd8-9e18-bde470f28ee1_ami-identity-44edb1225ab56981aa15e01311cd503c-2022-10-20T23-55-57.605Z_cropped.png/800x800cc.jpg",
                "coverart": "https://is1-ssl.mzstatic.com/image/thumb/Music123/v4/6c/e8/37/6ce837a3-d2d6-d1d0-1586-a3205c9813a1/0094636010359.jpg/400x400cc.jpg",
                "coverarthq": "https://is1-ssl.mzstatic.com/image/thumb/Music123/v4/6c/e8/37/6ce837a3-d2d6-d1d0-1586-a3205c9813a1/0094636010359.jpg/400x400cc.jpg",
                "joecolor": "b:010006p:c8c8cbs:e37b74t:a0a0a3q:b6625e"
            },
            "display": {
                "actions": [
                    {
                        "name": "display:updateshazam",
                        "type": "webview",
                        "uri": "https://www.shazam.com/inapp/updatenow/239201"
                    }
                ]
            },
            "share": {
                "subject": "Enjoy the Silence - Depeche Mode",
                "text": "Enjoy the Silence by Depeche Mode",
                "href": "https://www.shazam.com/track/239201/enjoy-the-silence",
                "image": "https://is1-ssl.mzstatic.com/image/thumb/Music123/v4/6c/e8/37/6ce837a3-d2d6-d1d0-1586-a3205c9813a1/0094636010359.jpg/400x400cc.jpg",
                "twitter": "I used @Shazam to discover Enjoy the Silence by Depeche Mode.",
                "html": "https://www.shazam.com/snippets/email-share/239201?lang=en-US&country=GB",
                "avatar": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages112/v4/82/64/c0/8264c0fd-982c-39f5-9d9c-107a770d9854/d8732264-4180-4cd8-9e18-bde470f28ee1_ami-identity-44edb1225ab56981aa15e01311cd503c-2022-10-20T23-55-57.605Z_cropped.png/800x800cc.jpg",
                "snapchat": "https://www.shazam.com/partner/sc/track/239201"
            },
            "hub": {
                "type": "APPLEMUSIC",
                "image": "https://images.shazam.com/static/icons/hub/web/v5/applemusic.png",
                "actions": [
                    {
                        "name": "apple",
                        "type": "applemusicplay",
                        "id": "665404759"
                    },
                    {
                        "name": "apple",
                        "type": "uri",
                        "uri": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/b6/ef/01/b6ef01b2-41b7-e627-ec1d-2c2fe7ab38ab/mzaf_15087153114570108328.plus.aac.ep.m4a"
                    }
                ],
                "explicit": false,
                "displayname": "APPLE MUSIC",
                "options": [
                    {
                        "caption": "OPEN IN",
                        "actions": [
                            {
                                "name": "hub:applemusic:deeplink",
                                "type": "applemusicopen",
                                "uri": "https://music.apple.com/gb/album/enjoy-the-silence/665404621?i=665404759&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_web&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_web"
                            },
                            {
                                "name": "hub:applemusic:deeplink",
                                "type": "uri",
                                "uri": "https://music.apple.com/gb/album/enjoy-the-silence/665404621?i=665404759&mttnagencyid=s2n&mttnsiteid=125115&mttn3pid=Apple-Shazam&mttnsub1=Shazam_web&mttnsub2=5348615A-616D-3235-3830-44754D6D5973&itscg=30201&app=music&itsct=Shazam_web"
                            }
                        ],
                        "beacondata": {
                            "type": "open",
                            "providername": "applemusic"
                        },
                        "image": "https://images.shazam.com/static/icons/hub/web/v5/overflow-open-option.png",
                        "type": "open",
                        "listcaption": "Open in Apple Music",
                        "overflowimage": "https://images.shazam.com/static/icons/hub/web/v5/applemusic-overflow.png",
                        "colouroverflowimage": false,
                        "providername": "applemusic"
                    }
                ]
            },
            "sections": [
                {
                    "type": "SONG",
                    "metapages": [
                        {
                            "image": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages112/v4/82/64/c0/8264c0fd-982c-39f5-9d9c-107a770d9854/d8732264-4180-4cd8-9e18-bde470f28ee1_ami-identity-44edb1225ab56981aa15e01311cd503c-2022-10-20T23-55-57.605Z_cropped.png/800x800cc.jpg",
                            "caption": "Depeche Mode"
                        },
                        {
                            "image": "https://is1-ssl.mzstatic.com/image/thumb/Music123/v4/6c/e8/37/6ce837a3-d2d6-d1d0-1586-a3205c9813a1/0094636010359.jpg/400x400cc.jpg",
                            "caption": "Enjoy the Silence"
                        }
                    ],
                    "tabname": "Song",
                    "metadata": [
                        {
                            "title": "Album",
                            "text": "Violator"
                        },
                        {
                            "title": "Label",
                            "text": "Venusnote Ltd."
                        },
                        {
                            "title": "Released",
                            "text": "1990"
                        }
                    ]
                },
                {
                    "type": "RELATED",
                    "url": "https://cdn.shazam.com/shazam/v3/en-US/GB/web/-/tracks/track-similarities-id-239201?startFrom=0&pageSize=20&connected=",
                    "tabname": "Related"
                }
            ],
            "url": "https://www.shazam.com/track/239201/enjoy-the-silence",
            "artists": [
                {
                    "alias": "depeche-mode",
                    "id": "42",
                    "adamid": "148377"
                }
            ],
            "alias": "enjoy-the-silence",
            "genres": {
                "primary": "Pop"
            },
            "urlparams": {
                "{tracktitle}": "Enjoy+the+Silence",
                "{trackartist}": "Depeche+Mode"
            },
            "highlightsurls": [],
            "relatedtracksurl": "https://cdn.shazam.com/shazam/v3/en-US/GB/web/-/tracks/track-similarities-id-239201?startFrom=0&pageSize=20&connected=",
            "albumadamid": "665404621",
            "trackadamid": "665404759",
            "releasedate": "19-03-1990",
            "isrc": "GBAJH0600292"
        },
        "tagid": "402DDCCF-0D72-4215-AD77-4F24224F3288"
    }
}
轨道 — 代码片段

    curl --location 'https://zylalabs.com/api/13548/spotify+track+match+api/30088/track' \
    --header 'Content-Type: multipart/form-data' \ 
    --form 'image=@"FILE_PATH"'

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Spotify 曲目匹配 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

该API通过分析上传的音频文件并将其内容与音乐识别数据库进行匹配来提供基于音频的音乐识别。它旨在确定给定音频样本中存在的歌曲或录音,并返回关于检测到的曲目的结构化信息

该API接受音频文件作为输入,并处理其声学特征以识别潜在匹配。当找到匹配时,响应可以包含曲目标题、艺术家、专辑、流派、发行信息、标识符和与识别录音相关的其他元数据等信息

Spotify 曲目匹配 API FAQs

轨道终端返回有关已识别歌曲的详细信息,包括曲目标题、艺术家、专辑、类型、发行信息和元数据。它还提供标识符和音乐服务的链接

响应中的关键字段包括“状态”表示成功,“匹配”包含识别到的轨道数组,并且每个匹配包括“id”、“偏移量”、“时间偏差”和“频率偏差”以进行精确识别

响应数据以JSON格式结构化。它包含一个顶级的“状态”字段和一个“结果”对象,该对象包含一个“匹配”数组,每个匹配具有与识别到的轨道相关的特定属性

轨道端点提供有关歌曲标题、艺术家、专辑、流派、发行日期和其他元数据的信息,使用户能够深入了解识别的曲目

跟踪端点接受音频文件作为输入 用户应确保文件为支持的音频格式如MP3或WAV以便成功处理和识别

用户可以利用返回的数据在应用程序中显示歌曲信息 创建播放列表或分析音乐趋势 "id" 可用于从音乐服务中获取更多信息

Track端点使用一个音乐识别数据库,该数据库聚合了来自各种音乐服务的数据,确保了广泛的曲目覆盖和准确的识别

典型的用例包括在应用程序中的音乐识别 增强音乐发现中的用户体验 以及在社交媒体平台或娱乐应用中集成音乐识别功能

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]