微博热搜榜实时上升热点免费API接口使用指南

接口简介

该API由接口盒子apihz.cn提供，用于获取新浪微博热搜榜中的实时上升热点数据。这些热点数据代表了当前正在快速上升的热门话题，对于舆情监控、内容运营和趋势分析具有重要价值。

接口基础信息

• ​请求地址​：https://cn.apihz.cn/api/xinwen/weibo2.php

• ​请求方式​：GET或POST

• ​请求参数​：

  参数名	必填	说明	示例
  id	是	用户中心的数字ID	id=10000000
  key	是	用户中心通讯秘钥	key=15he5h15ty...

• ​返回参数​：

  参数名	说明
  code	状态码（200成功，400错误）
  msg	错误信息（code=400时返回）
  time	数据缓存时间戳（Unix时间戳）
  time2	数据缓存时间（YYYY-MM-DD HH:MM:SS）
  data	热搜榜单数据数组
  title	热搜标题（第一条为置顶内容）
  icon	热搜类型图标地址
  scheme	热搜详情页地址
  desc_extr	热度值（数字或状态描述）

📌 注意：示例ID/KEY（88888888）为公共测试账号，频次受限。建议注册账号获取专属ID/KEY

调用示例

PHP调用示例

php

复制

<?php
$api_url = "https://cn.apihz.cn/api/xinwen/weibo2.php";
$user_id = "YOUR_USER_ID";  // 替换为实际ID
$api_key = "YOUR_API_KEY";  // 替换为实际KEY

// 构建GET请求
$request_url = $api_url . "?id=" . $user_id . "&key=" . $api_key;

// 发送请求
$response = file_get_contents($request_url);

// 解析JSON响应
$data = json_decode($response, true);

// 处理结果
if ($data['code'] == 200) {
    echo "数据缓存时间: " . $data['time2'] . "\n";
    echo "热搜榜单:\n";
    foreach ($data['data'] as $index => $item) {
        echo ($index + 1) . ". " . $item['title'];
        echo " | 热度: " . $item['desc_extr'] . "\n";
    }
} else {
    echo "请求失败: " . $data['msg'];
}
?>

Python调用示例

python

运行

复制

import requests

api_url = "https://cn.apihz.cn/api/xinwen/weibo2.php"
user_id = "YOUR_USER_ID"   # 替换为实际ID
api_key = "YOUR_API_KEY"   # 替换为实际KEY

# 构建请求参数
params = {
    "id": user_id,
    "key": api_key
}

try:
    # 发送GET请求
    response = requests.get(api_url, params=params)
    data = response.json()
    
    if data['code'] == 200:
        print(f"数据缓存时间: {data['time2']}")
        print("实时上升热点榜:")
        for idx, item in enumerate(data['data']):
            rank = idx + 1
            print(f"{rank}. {item['title']} | 热度: {item['desc_extr']}")
    else:
        print(f"请求失败: {data['msg']}")

except Exception as e:
    print(f"请求异常: {str(e)}")

返回数据结构示例（成功）

json

复制

{
  "code": 200,
  "time": 1720717672,
  "time2": "2024-07-12 01:07:52",
  "data": [
    {
      "title": "艾热早安模仿借位吻",
      "icon": "https://simg.s.weibo.com/...",
      "desc_extr": "正在热转",
      "scheme": "https://m.weibo.cn/search?..."
    },
    {
      "title": "为何买回家的面包要放冰箱冷冻室",
      "icon": "https://simg.s.weibo.com/...",
      "desc_extr": "正在投票",
      "scheme": "https://m.weibo.cn/search?..."
    },
    // ...更多热搜条目...
  ]
}

返回数据结构示例（失败）

json

复制

{
  "code": 400,
  "msg": "查询失败,请重试。"
}

使用注意事项

1. ​数据更新频率​：数据最长每10分钟更新一次（根据time2字段判断）
2. ​热点类型识别​：
   • desc_extr为数字：表示具体热度值（如40967）
   • desc_extr为文本：表示特殊状态（如"正在热转"）
3. ​第一条数据​：data数组的第一项为置顶内容
4. ​图标字段​：icon可能返回null，需做空值处理
5. ​频次限制​：使用个人账号可享独立频次，避免公共账号限制

通过这个免费API，开发者可以轻松将微博的实时上升热点数据集成到自己的应用中，适用于舆情监控系统、内容推荐引擎、社交媒体分析平台等多种场景。