Friends Data API独立数据服务

DECISION MODEL DATA · 娱乐与榜单

Billboard

歌曲与专辑榜的排名、榜期及在榜表现。

API 调用说明

能回答的问题

  • 某首歌在 Hot 100 的排名怎样变化?
  • 某张专辑在 Billboard 200 的最高名次是多少?

状态与已知缺口

部分可用

仅覆盖本页列出的已取得数据;提供方的全部产品、历史期次及修订版本未全部覆盖。

  • 榜单来自独立存档,不能保证与官方修订版本一致
  • 其他榜种和部分榜期尚未覆盖

提供方

PRODUCT

Billboard 200 专辑榜存档

billboard_album_200

一条专辑在一个榜期的排名观察,包含当周、上周、最高名次与在榜周数;来自独立 CSV 存档。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
1967-04-15 ~ 2024-10-26 · 榜单周日期
采集时间
2026-10-06T13:06:23.854660Z ~ 2026-10-06T13:06:23.854660Z
记录数
600,649

API 调用示例

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

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

字段表 · 11 个字段

字段名中文说明
chart_week榜单周段或周日期
current_week当周名次
last_week上一周名次原文
native_conflict提供方原生字段;含义暂未补充。
native_identity_ordinal提供方原生字段;含义暂未补充。
occurrence_count提供方原生字段;含义暂未补充。
original_positions提供方原生字段;含义暂未补充。
peak_pos最高名次
performer表演者或艺人
title标题或名称
wks_on_chart累计在榜周数

PRODUCT

Billboard Hot 100 歌曲榜存档

billboard_hot100

一首歌曲在一个榜期的排名观察,包含艺人、当周与上周名次、最高名次和在榜周数。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
1958-08-04 ~ 2026-10-10 · 榜单日期
采集时间
2026-10-04T07:55:24.588020Z ~ 2026-10-06T12:13:51.492148Z
记录数
355,887

API 调用示例

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

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

字段表 · 7 个字段

字段名中文说明
artist艺人名称
chart_date榜单日期
last_week上一周名次原文
peak_position最高名次
song歌曲或作品标题
this_week当周名次
weeks_on_chart累计在榜周数

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