You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

iTunes API获取音乐实体报错:为何entity=music参数无效?

解决iTunes Search API的resultEntity错误问题

嘿,这个问题我之前也踩过坑!你遇到的错误根源很明确:music并不是entity参数的合法取值——大概率是你把media参数和entity参数的用法搞混啦。

iTunes Search API里,entity参数是用来指定返回结果的具体细分类型,针对音乐类的合法entity值包括这些:

  • musicTrack:单首音乐曲目
  • musicArtist:艺术家条目
  • musicAlbum:专辑条目
  • musicVideo:音乐视频内容

而你误以为的music,其实是media参数的合法值——这个参数是用来限定搜索的媒体大类(比如music、movie、podcast等)。

修正你的调用很简单,把entity=music换成上面的合法值就行。比如要搜索Ed Sheeran的单曲,正确的调用地址是:

https://itunes.apple.com/search?term=Ed+Sheeran&entity=musicTrack

如果想进一步精准筛选,还可以同时加上media=music明确限定媒体类型,比如只返回他的专辑结果:

https://itunes.apple.com/search?term=Ed+Sheeran&media=music&entity=musicAlbum

内容的提问来源于stack exchange,提问作者Karol Makara

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.14 07:57:07