说明

获取指定城市的同城热点榜单。不传 city_code 时返回默认城市。

基础信息

Endpoint:: GET /openapi/v1/contentcreator/douyin/billboard/fetch_hot_city_list
计费:: 1 积分 / 次
限流:: 300 次 / 分钟 / 用户

请求参数说明

参数	类型	必填	说明
page	string	是	页码，从 1 开始
page_size	string	是	单页条数
order	string	是	排序字段，如 hot_score
city_code	string	否	城市编码（参考 douyin 城市列表接口）
sentence_tag	string	否	句子标签过滤
keyword	string	否	关键词过滤

响应字段说明

字段	类型	说明
code	int	业务状态码，200 表示成功
request_id	string	本次请求唯一标识，排查问题时可提供
data	object	业务数据容器，具体字段见下
list / word_list	array	榜单条目列表
word / sentence	string	热点词 / 话题
hot_value / hot_score	int	热度值
position / rank	int	排名
sentence_id / query_id	string	话题 ID（可传给「话题相关视频」接口）
event_time / snapshot_time	int	上榜 / 快照时间

请求示例 · cURL

curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/douyin/billboard/fetch_hot_city_list?page=1&page_size=10&order=hot_score&city_code=110000' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'

响应示例

{
  "code": 200,
  "request_id": "79fd3c97-0d5d-43f7-8915-c35e4c954ef2",
  "data": {
    "code": 0,
    "data": {
      "page": {
        "page": 1,
        "page_size": 10,
        "total": 14
      },
      "objs": [
        {
          "rank": 2,
          "rank_diff": 5,
          "sentence": "罕见病患儿终审获赔百万重疾金",
          "sentence_id": 2509875,
          "create_at": 1779543681,
          "hot_score": 5347179,
          "video_count": 1,
          "sentence_tag": 4003,
          "city_code": 110000,
          "trends": [
            {
              "datetime": "20260524080500",
              "hot_score": 5386954
            },
            "... and 54 more"
          ],
          "index": 1,
          "SnapshotSubType": "110000",
          "city_name": "北京",
          "sentence_tag_name": "社会",
          "SnapshotType": 1,
          "SnapshotID": 20260524170500,
          "first_item_cover_url": "",
          "is_favorite": false,
          "item_list": null,
          "item_list_i64": null,
          "recommend_type": null,
          "related_event": null,
          "allow_publish": false,
          "label_name": "",
          "label": 0
        },
        "... and 9 more"
      ],
      "last_update_time": "20260524170500"
    },
    "extra": {
      "now": 1779613855000
    }
  }
}

开始调用 SpiderHubs API

使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。

获取 API Key 查看定价