Spotify API

Spotify 搜索 API

按关键词在 Spotify 中搜索匹配的单曲、专辑、艺人、播客和播放列表。

POST/v1/run/spotify.search
可用率
100.00%
30d · 6 次调用
请求数
6
30d
响应时间
7.9s
中位数 · 30d

价格

一个价格，以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "albums": [
      {
        "artistName": "Example title",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "type": "general",
        "uri": "example",
        "year": 2024
      }
    ],
    "artists": [
      {
        "id": "a1b2c3d4",
        "name": "Example title",
        "uri": "example",
        "verified": true
      }
    ],
    "podcasts": [
      {
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "publisher": "example",
        "uri": "example"
      }
    ],
    "tracks": [
      {
        "albumName": "Example title",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "name": "Example title",
        "uri": "example"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface SpotifySearchResponse {
  data: {
    albums: {
      artistName?: string;
      id: string;
      image?: string;
      name: string;
      type?: string;
      uri: string;
      year: number;
    }[];
    artists: {
      id: string;
      name: string;
      uri: string;
      verified: boolean;
    }[];
    podcasts: {
      id: string;
      image?: string;
      name: string;
      publisher: string;
      uri?: string;
    }[];
    tracks: {
      albumName?: string;
      id: string;
      image?: string;
      name: string;
      uri: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/spotify.search
curl -X POST https://api.getanyapi.com/v1/run/spotify.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"my first million"}'
字段类型示例值
请求体
querystring"my first million"搜索词（例如 "my first million"）。
响应
dataobject
data.albumsobject[]Populated whenever the provider has data for the entity.
data.albums[].artistNamestringName of the primary artist.
data.albums[].idstring
data.albums[].imagestringURL of the cover art image.
data.albums[].namestring
data.albums[].typestringAlbum type, for example ALBUM, SINGLE or COMPILATION.
data.albums[].uristring
data.albums[].yearinteger
data.artistsobject[]Populated whenever the provider has data for the entity.
data.artists[].idstring
data.artists[].namestring
data.artists[].uristring
data.artists[].verifiedboolean
data.podcastsobject[]Populated whenever the provider has data for the entity.
data.podcasts[].idstring
data.podcasts[].imagestringURL of the cover art image.
data.podcasts[].namestring
data.podcasts[].publisherstring
data.podcasts[].uristringSpotify URI of the podcast show.
data.tracksobject[]Populated whenever the provider has data for the entity.
data.tracks[].albumNamestringName of the album the track appears on.
data.tracks[].idstringPopulated whenever the provider has data for the entity.
data.tracks[].imagestringURL of the cover art image.
data.tracks[].namestringPopulated whenever the provider has data for the entity.
data.tracks[].uristringPopulated whenever the provider has data for the entity.
foundboolean
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.0012
价格（/千次请求）USDUS$1.20

常见问题

关于 Spotify 搜索 API

AnyAPI 的 Spotify 搜索 API 只需一次 POST 请求 /v1/run/spotify.search，就以统一格式的 JSON 返回 Spotify 数据。按关键词在 Spotify 中搜索匹配的单曲、专辑、艺人、播客和播放列表。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$1.20 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Spotify 搜索 API 调用中有 100.0% 成功，响应时间中位数为 7.9 秒，共测量 6 次调用。

费用：每千次请求 US$1.20 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词在 Spotify 中搜索匹配的单曲、专辑、艺人、播客和播放列表。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Spotify 搜索 API 调用中有 100.0% 成功，响应时间中位数为 7.9 秒，共测量 6 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

Spotify 的其他接口

专辑/千次请求 US$1.20 起艺人/千次请求 US$1.20 起播放次数/千次请求 US$3.30 起播客/千次请求 US$1.20 起播客单集/千次请求 US$1.20 起单曲/千次请求 US$1.20 起