Friends Data API独立数据服务

DECISION MODEL DATA · 娱乐与榜单

Circle Chart

韩国专辑周榜,以及 Hanteo 的独立实体专辑榜。

API 调用说明

能回答的问题

  • 某张专辑在 Circle 周榜的名次怎样?
  • Hanteo 榜与 Circle 榜的排序是否不同?

状态与已知缺口

部分可用

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

  • Circle 其他榜种及频率尚未全部覆盖,部分榜期未取得有效榜单
  • Hanteo 零售实体销量口径不等于 Circle 统计口径

提供方

PRODUCT

Circle 专辑周榜

circle_chart_album_weekly

一个已取得榜期中的一条专辑名次记录;保留专辑、艺人、当期与累计计数和排名变化,具体口径依原榜。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
2010-W01 ~ 2026-W39 · 榜单年度与周次
采集时间
2026-10-06T07:35:02.555842Z ~ 2026-10-06T14:03:13.060644Z
记录数
87,000

API 调用示例

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

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

字段表 · 18 个字段

字段名中文说明
ALBUM_NAME专辑名称
ARTIST_NAME艺人名称
Album_CNT该期专辑计数;按 Circle 原榜口径解读
Album_Hit_ratio提供方原生字段;含义暂未补充。
Certify_Grade提供方原生字段;含义暂未补充。
CntYN提供方原生字段;含义暂未补充。
FILE_NAME提供方原生字段;含义暂未补充。
PRE_SERVICE_RANKING上一期榜单名次
RankChange名次变动幅度
RankStatus名次上升或下降状态
SERVICE_RANKING该期榜单名次
TotHitRatio提供方原生字段;含义暂未补充。
Total_CNT累计专辑计数;与当期计数分开使用
de_nm发行或分销方名称
native_ordinal提供方原生字段;含义暂未补充。
native_period提供方原生字段;含义暂未补充。
native_request_context提供方原生字段;含义暂未补充。
seq_aoa提供方专辑条目标识

PRODUCT

Hanteo 实体专辑周榜

circle_chart_hanteo_album

一条 Hanteo 周榜专辑记录,含艺人和名次;不同于 Circle 专辑统计,本产品未提供销售数量。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
2026-W37 ~ 2026-W37 · 原文榜单周段
采集时间
2026-10-04T07:55:35.030032Z ~ 2026-10-04T07:55:35.030032Z
记录数
20

API 调用示例

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

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

字段表 · 5 个字段

字段名中文说明
album专辑名称
artist艺人名称
chart_period榜单统计周期原文
display_order提供方原生字段;含义暂未补充。
rank原文名次;并列或非数值符号按原样保留

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