Music Catalog Intelligence for Spotify

Search, analyze, and retrieve structured Spotify catalog metadata for artists, tracks, albums, playlists, shows, and episodes.

原始信息汇总

Music Catalog Intelligence for Spotify 数据集详情

基本信息

• API名称：Music Catalog Intelligence for Spotify
• 类别：Music
• 创造者：zenAPI
• 订阅者数：1
• 人气度：9
• 服务等级：100%
• 延迟：496ms
• 测试通过率：100%

定价方案

• BASIC：$0.00/月
• PRO（⭐推荐）：$9.99/月
• ULTRA：$29.99/月
• MEGA：$99.99/月

核心功能概述

该API提供对Spotify音乐目录的结构化访问，支持艺人（artists）、曲目（tracks）、专辑（albums）、播放列表（playlists）、节目（shows）和剧集（episodes）的元数据检索与分析。支持通过Spotify链接、URI或ID进行查找，目录搜索，批量请求处理和播放列表构成分析，响应采用统一的JSON格式。

主要终端节点

1. Catalog（目录查询）

• GET /v1/catalog — 通过Spotify链接或URI获取单个项目
  • 可选参数：entity_type（仅裸ID时需要）、max_tracks（播放列表曲目数，1-500，默认100）、max_episodes（节目剧集数，1-500，默认50）
• GET /v1/{entity_type}/{spotify_id} — 通过ID获取项目（紧凑形式）
• GET /v1/search — 搜索目录
  • 参数：query（必填，搜索文本）、types（类型列表，默认全部六种）、limit（每种类型结果数，1-20，默认10）、enrich（设为true可获取完整记录）
• POST /v1/batch — 批量查询，一次最多请求50个目标
  • 响应包含成功的results和失败的errors两部分

2. Playlist Intelligence（播放列表分析）

• GET /v1/playlists/analysis — 分析播放列表构成
  • 响应包含播放列表记录及加载曲目数、唯一曲目数、重复曲目数、唯一艺人数、顶级艺人占比和艺人多样性指标
• GET /v1/playlists/{playlist_id}/analysis — 使用播放列表ID的等价形式

响应格式

所有目录查询返回统一格式的JSON响应，包含：

• record_type（记录类型）
• id（Spotify ID）
• uri（Spotify URI）
• url（Spotify链接）
• data（目录项目的可用数据字段）
• scraped_at（抓取时间戳）

搜索响应包含query、types、result_count和items字段。

身份验证与错误处理

• 通过RapidAPI的标准身份验证机制完成鉴权，无需发送或请求提供商的私有代理密钥
• 常见状态码：200（成功）、401（无效的RapidAPI身份验证）、422（无效参数）、502（目录供应商暂时不可用）