首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >微博热搜榜实时上升热点免费API接口使用指南

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

原创
作者头像
用户9840656
发布2025-07-14 17:43:00
发布2025-07-14 17:43:00
72300
代码可运行
举报
运行总次数:0
代码可运行

接口简介

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

接口基础信息

  • 请求地址​:https://cn.apihz.cn/api/xinwen/weibo2.php
  • 请求方式​:GET或POST
  • 请求参数​: 参数名必填说明示例id是用户中心的数字IDid=10000000key是用户中心通讯秘钥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调用示例
代码语言:javascript
代码运行次数:0
运行
复制
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调用示例
代码语言:javascript
代码运行次数:0
运行
复制
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)}")

返回数据结构示例(成功)

代码语言:javascript
代码运行次数:0
运行
复制
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?..."
    },
    // ...更多热搜条目...
  ]
}

返回数据结构示例(失败)

代码语言:javascript
代码运行次数:0
运行
复制
json复制{
  "code": 400,
  "msg": "查询失败,请重试。"
}

使用注意事项

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

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

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口简介
  • 接口基础信息
  • 调用示例
    • PHP调用示例
    • Python调用示例
  • 返回数据结构示例(成功)
  • 返回数据结构示例(失败)
  • 使用注意事项
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档