介绍

欢迎使用今日热榜官方 API 服务。

今日热榜是全网最全面的热榜聚合平台,汇集了各大网站的热榜信息,包括微信、今日头条、百度、知乎、V2EX、微博、贴吧、豆瓣、天涯、虎扑、Github、抖音等,基本囊括所有中文互联网平台榜单。使用今日热榜提供的 API,可快速接入热榜数据,助力追踪全网热点。

注意:
我们的数据仅获取对应网站榜单的单一页面,
仅获取上榜内容的标题和链接地址,不会深入去获取链接地址对应的原始内容。

入门

本文档描述了构成官方 今日热榜 JSON API 的资源。

如果您有任何问题或请求,请联系我们的 API 团队

创建帐户

要访问 今日热榜 API,请首先注册加入.

指南和条款

要使用 API,您必须遵守隐私政策条款遵循用户协议

全局说明

通用请求

请求域名

https://api.tophubdata.com/

用户认证

请通过 HTTP 授权标头 HEADER 传递应用程序的访问密钥:Authorization: YOUR_ACCESS_KEY

请务必保存好自己的密钥,你可以通过在后台设置中心设置白名单IP来限制请求服务器来源(默认关闭)。

参数名 必选 类型 说明 示例值
Authorization string 用户密钥 e5ff6cf3a14e1c72deefe8a512469af6
IP string 用户请求 IP 地址 127.0.0.1(后台开启白名单模式需要带上当前 IP 地址)

错误码

错误码及描述

错误码 描述 说明
200 Success 成功
100101 InvalidParams 缺少参数或无效的参数
100201 Unauthorized 未授权Authorization错误
100202 IpRestricted 请求 IP 受限,检查白名单
100300 InsufficientFunds 账户余额不足
100500 InternalError 内部错误

开放接口

全部榜单列表

描述

获得今日热榜全站全部榜单列表。

地址

https://api.tophubdata.com/nodes

方法

GET

参数

参数名 必选 类型 说明 示例值
p int 翻页页码,每页100条 1

可以递归查询,当返回的条数 <100 的时候中断递归,=100 的时候 p++ 来实现自动翻页获取所有节点。

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes?p=1' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": [
        {
            "hashid": "KqndgxeLl9",
            "name": "微博",
            "display": "热搜榜",
            "domain": "weibo.com",
            "logo": "********"
        },
        {
            "hashid": "mproPpoq6O",
            "name": "知乎",
            "display": "热榜",
            "domain": "zhihu.com",
            "logo": "********"
        }
        ...
    ]
  }

返回参数说明

参数名 类型 说明 示例值
hashid varchar 榜单hashid mproPpoq6O(注意 hashid 严格区分大小写)
name varchar 网站名称 知乎
display varchar 内容类型 热榜
domain varchar 域名 zhihu.com
logo varchar 图标 **

单个榜单最新详细

描述

获得指定榜单的最新榜单或最新更新的内容列表。数据排序即为最新榜单排序。本接口一次性返回最新榜单全部内容,不用翻页。

地址

https://api.tophubdata.com/nodes/@hashid

@hashid 为全部榜单列表获取到的 hashid,注意 hashid 严格区分大小写。

方法

GET

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes/mproPpoq6O' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": {
        "hashid": "mproPpoq6O",
        "name": "知乎",
        "display": "热榜",
        "domain": "zhihu.com",
        "logo": "********",
        "items": [
            {
                "extra": "455 万热度",
                "url": "https://www.zhihu.com/question/629047878",
                "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
                "description": "美联储加息周期终于似要走到尽头了。 ",
                "title": "美元大跳水,10 年期美债收益率大跌,离岸人民币大涨 400 点,美股五连阳,美联储加息周期到头了吗?"
            },
            {
                "extra": "206 万热度",
                "url": "https://www.zhihu.com/question/621684259",
                "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
                "description": "感觉老一辈的亲戚总是不知道一些边界感,每次都无下限的打探我的个人问题和生活,弄得我非常的不适。要怎么样才能有礼貌的进行回应呢?",
                "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界,是我太敏感还是「亲戚PTSD」在作祟?"
            }
            ...
        ]
    }
  }

返回参数说明

参数名 类型 说明
hashid varchar 榜单节点 Hashid
name varchar 网站名称
display varchar 内容类型
domain varchar 域名
logo varchar 图标
items/title varchar 标题
items/description varchar 描叙
items/thumbnail varchar 缩略图
items/url varchar 地址
items/extra unknown 附加内容,可能是任意格式内容

单个榜单历史数据集

描述

获得榜单指定日期当天上榜的所有历史数据集,需要指定日期,一次性返回当天所有上榜数据,排序为上榜时间从先到后,本接口仅用来获取今天以前的历史日期数据,不返回当天数据。本接口一次性返回当天所有内容,不用翻页。

地址

https://api.tophubdata.com/nodes/@hashid/historys

@hashid 为全部榜单列表获取到的 hashid,注意 hashid 严格区分大小写。

方法

GET

参数

参数名 必选 类型 说明 示例值
date String 日期Y-m-d 2023-01-01

cURL 请求示例

curl --location 'https://api.tophubdata.com/nodes/mproPpoq6O/historys?date=2023-11-04' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": [
        {
            "extra": "455 万热度",
            "url": "https://www.zhihu.com/question/629047878",
            "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
            "description": "美联储加息周期终于似要走到尽头了。 ",
            "title": "美元大跳水,10 年期美债收益率大跌,离岸人民币大涨 400 点,美股五连阳,美联储加息周期到头了吗?",
            "time" : 1699095601
        },
        {
            "extra": "206 万热度",
            "url": "https://www.zhihu.com/question/621684259",
            "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
            "description": "感觉老一辈的亲戚总是不知道一些边界感,每次都无下限的打探我的个人问题和生活,弄得我非常的不适。要怎么样才能有礼貌的进行回应呢?",
            "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界,是我太敏感还是「亲戚PTSD」在作祟?",
            "time" : 1699095601
        }
        ...
    ]
  }

返回参数说明

参数名 类型 说明
title varchar 标题
description varchar 描叙
thumbnail varchar 缩略图
url varchar 地址
extra unknown 附加内容,可能是任意格式内容
time int 10位时间戳(上榜时间)

全网热点内容搜索

描述

搜索全站热点或者指定榜单节点内容。

地址

https://api.tophubdata.com/search

方法

GET

参数

参数名 必选 类型 说明 示例值
q String 关键词 苹果
hashid String 搜索限定节点 hashid mproPpoq6O
p Int 当前页码(每页最多返回50条,默认1) 1

cURL 请求示例

curl --location 'https://api.tophubdata.com/search?q=Apple&nodeid=mproPpoq6O&p=1' --header 'Authorization: YOUR_ACCESS_KEY'

可以复制上面示例到 Postman 这类型调试工具直接运行。

返回示例

  {
    "error":false,
    "status":200
    "data": {
        "p": 1,
        "pagesize": 50,
        "totalpage": 2,
        "totalsize": 99,
        "items": [
            {
                "extra": "455 万热度",
                "url": "https://www.zhihu.com/question/629047878",
                "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
                "description": "美联储加息周期终于似要走到尽头了。 ",
                "title": "美元大跳水,10 年期美债收益率大跌,离岸人民币大涨 400 点,美股五连阳,美联储加息周期到头了吗?"
            },
            {
                "extra": "206 万热度",
                "url": "https://www.zhihu.com/question/621684259",
                "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
                "description": "感觉老一辈的亲戚总是不知道一些边界感,每次都无下限的打探我的个人问题和生活,弄得我非常的不适。要怎么样才能有礼貌的进行回应呢?",
                "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界,是我太敏感还是「亲戚PTSD」在作祟?"
            }
            ...
        ]
    }
  }

返回参数说明

参数名 类型 说明
p int 当前页码
totalsize int 总匹配数
pagesize int 每页返回记录数
totalpage int 总页数
items/title varchar 标题
items/description varchar 描叙
items/thumbnail varchar 缩略图
items/url varchar 地址
items/extra unknown 附加内容,可能是任意格式内容

实时回调

Webhook 回调

当我们的系统更新某个网站的榜单时,我们会立即向您指定的 URL 发送一个回调,包含最新的榜单内容。

通过这种方式,您可以实时获取最新的数据,确保您获得的数据与我们的系统高度同步,而且不会遗漏任何信息。

Webhook 通知向您指定的 URL 发送 HTTP POST 请求。请求消息主体是序列化的 JSON 字符串,采用application/json请求头。

请求 POST JSON 数据示例

  {
      "hashid": "mproPpoq6O",
      "name": "知乎",
      "display": "热榜",
      "domain": "zhihu.com",
      "logo": "********",
      "items": [
          {
              "extra": "455 万热度",
              "url": "https://www.zhihu.com/question/629047878",
              "thumbnail": "https://pica.zhimg.com/80/v2-00a693d9ac81c601223512d5725cbacd_1440w.png",
              "description": "美联储加息周期终于似要走到尽头了。 ",
              "title": "美元大跳水,10 年期美债收益率大跌,离岸人民币大涨 400 点,美股五连阳,美联储加息周期到头了吗?"
          },
          {
              "extra": "206 万热度",
              "url": "https://www.zhihu.com/question/621684259",
              "thumbnail": "https://pic3.zhimg.com/50/v2-0e599dcb44ad61215462fdfbb58d983e_qhd.jpg",
              "description": "感觉老一辈的亲戚总是不知道一些边界感,每次都无下限的打探我的个人问题和生活,弄得我非常的不适。要怎么样才能有礼貌的进行回应呢?",
              "title": "过节聚餐时总感到亲戚在惯性「侵犯」我的边界,是我太敏感还是「亲戚PTSD」在作祟?"
          }
          ...
      ]
  }

您的URL应在几秒钟内响应 2xx 状态代码,否则可能会重试 Webhook。对于失败的响应,我们在2分钟内会尝试重试3次(间隔30s),不会无限制重试,请确保响应 URL 一直处于无阻塞状态。

值得注意的是,这个功能仅对我们的大客户开放,以确保服务的质量和效率。您无需逐个调用接口获取数据,而是通过回调即可获得所需的信息。

SDK 接入

演示 DEMO

注意,请勿在客户端直接调用 API,务必使用自己的服务器嵌套接口使用,同一 ACCESS_KEY 频繁变化请求 IP 会被系统直接禁用。以下是常见后端开发语言演示 Demo:

接口过于简单,大家也可以自己封装。