Friends Data API独立数据服务

DECISION MODEL DATA · 娱乐与榜单

Spotify Charts

Kworb 存档的 Spotify 地区歌曲排名与播放统计。

API 调用说明

能回答的问题

  • 某地区榜单的前列歌曲有哪些?
  • 哪些歌曲的日播放量或累计播放量较高?

状态与已知缺口

替代数据

采用第三方榜单作为已接受的替代范围;仅覆盖本页实际列出的地区榜与播放统计,全部历史期次和修订版本仍未覆盖。

  • Kworb 为第三方存档,与 Spotify 官方产品、地域和指标覆盖不同。
  • 日榜、周榜与累计统计口径不同;累计值不可用于重建逐日榜单。
  • 历史全部地区、期次与修订版本仍未证明穷尽。

提供方

PRODUCT

Kworb Spotify 地区榜与播放统计

spotify_charts_kworb_charts

一条地区榜或累计播放统计记录,含歌曲、名次及原表播放指标;累计总量不是逐日历史榜,须先看表头与榜期。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
2013-04-28 ~ 2026-10-04 · 原文榜期;累计表未标示日期时不可用
采集时间
2026-10-04T07:55:31.209737Z ~ 2026-10-06T12:10:50.058294Z
记录数
1,193,188

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=spotify_charts_kworb_charts&limit=100

字段表 · 20 个字段

字段名中文说明
artist_title艺人与作品组合标题
cells原表单元格及原文值;需结合表头解读
change原表变化值
chart_title原文榜单标题,用于区分指标和榜种
column_headers提供方原表列标题,使用展示值时需与表头对应
days原表天数指标
native_period提供方原生字段;含义暂未补充。
native_row_attributes提供方原生字段;含义暂未补充。
native_row_html提供方原生字段;含义暂未补充。
peak最高名次或峰值,按原表列名口径
peak_count原表最高名次出现次数展示值
period_label提供方统计期原文
rank原文名次;并列或非数值符号按原样保留
row_ordinal提供方原生字段;含义暂未补充。
seven_day原表七日统计值
seven_day_change七日统计变化值
streams原表播放量
streams_change播放量变化展示值
table_ordinal提供方原生字段;含义暂未补充。
total原表累计值;具体口径取决于表头

数据观测时间 2026-10-06T17:38:47.854586Z