data_structure.md 4.99 KB

微博多榜数据结构参考

一、热门搜索 API 数据结构

1.1 热搜榜返回字段

字段 类型 说明 示例
word string 热搜关键词/标题 "特朗普宣布关税政策"
word_scheme string 热搜跳转路径 "/hot/7890123"
num number 热度值 1234567
raw_hot number 原始热度值 1234567
rank number 排名 1
note string 热搜摘要 "特朗普宣布对多国加征关税"
flag number 数据有效性 (1=有效) 1
label_name string 标签 ("新"/"沸"/"爆") "新"
category string 分类 (可选) "社会"
icon string 图标 (可选) ""

1.2 字段说明

  • word: 热搜话题标题,用于展示和搜索
  • word_scheme: 跳转路径,可拼接为 https://weibo.com{word_scheme}
  • num: 计算后的热度值,可能经过标准化
  • raw_hot: 原始热度,未经处理的数值
  • rank: 当前排名,1-50
  • note: 热搜的简要描述,通常是词条的相关信息
  • flag: 数据有效性标志,1/2 表示有效,0 可能表示广告或无效
  • label_name: 标签,新、沸、爆 等

二、搜索详情 API 数据结构

2.1 搜索结果返回字段

字段 类型 说明
mid string 微博 ID
text string 微博正文 (HTML 格式)
pic_ids string[] 图片 ID 列表
user.id number 用户 ID
user.screen_name string 用户昵称
user.followers_count number 粉丝数
user.verified boolean 是否认证
reposts_count number 转发数
comments_count number 评论数
attitudes_count number 点赞数
created_at string 发布时间

2.2 图片 ID 转换为 URL

# pic_id 到完整 URL 的转换
pic_id = "CgyXxxx"
# 尺寸选项: thumb, bmiddle, large, mw690
image_url = f"https://wx1.sinaimg.cn/large/{pic_id}.jpg"

三、合并数据结构设计

3.1 每日汇总 JSON

{
  "date": "2026-03-29",
  "timestamp": "2026-03-29T10:30:00Z",
  "boards": {
    "hot": {
      "name": "热搜榜",
      "type": "hot",
      "url": "https://m.weibo.cn/api/index/list?type=hot",
      "count": 50,
      "items": [
        {
          "rank": 1,
          "word": "特朗普宣布关税政策",
          "word_scheme": "/hot/7890123",
          "url": "https://s.weibo.com/weibo?q=特朗普宣布关税政策",
          "detail_url": "https://m.weibo.cn/detail/5281181642153648",
          "hot_value": 1234567,
          "note": "特朗普宣布对多国加征关税",
          "label": "新",
          "flag": 1
        }
      ]
    },
    "entertainment": {
      "name": "文娱榜",
      "type": "entertainment",
      "url": "https://m.weibo.cn/api/index/list?type=entertainment",
      "count": 50,
      "items": [...]
    }
  },
  "metadata": {
    "version": "1.0",
    "source": "weibo_scraper",
    "total_items": 250,
    "boards_count": 5
  }
}

3.2 单条热搜数据结构

{
  "rank": 1,
  "word": "热搜关键词",
  "word_scheme": "/hot/123456",
  "url": "https://s.weibo.com/weibo?q=热搜关键词",
  "detail_url": "https://m.weibo.cn/detail/5281181642153648",
  "hot_value": 1234567,
  "note": "热搜摘要",
  "label": "新",
  "flag": 1,
  "category": "社会"
}

3.3 详情页数据结构 (可选扩展)

{
  "mid": "5281181642153648",
  "content": {
    "text": "微博正文内容",
    "text_html": "<p>微博正文内容</p>",
    "images": [
      {
        "pic_id": "CgyXxxx",
        "url": "https://wx1.sinaimg.cn/large/CgyXxxx.jpg"
      }
    ]
  },
  "author": {
    "id": 123456,
    "screen_name": "用户名",
    "followers_count": 10000,
    "verified": true,
    "verified_type": 0
  },
  "engagement": {
    "reposts_count": 100,
    "comments_count": 200,
    "attitudes_count": 500
  },
  "timestamp": "2026-03-29T10:00:00Z"
}

四、数据类型定义

4.1 TypeScript 接口

interface WeiboHotItem {
  rank: number;
  word: string;
  word_scheme: string;
  url: string;
  detail_url: string;
  hot_value: number;
  note: string;
  label: string;
  flag: number;
  category?: string;
}

interface WeiboBoard {
  name: string;
  type: string;
  url: string;
  count: number;
  items: WeiboHotItem[];
}

interface WeiboDailyReport {
  date: string;
  timestamp: string;
  boards: {
    [key: string]: WeiboBoard;
  };
  metadata: {
    version: string;
    source: string;
    total_items: number;
    boards_count: number;
  };
}

五、字段映射表

5.1 API 字段到输出字段

API 原始字段 输出字段 说明
word word 热搜关键词
word_scheme word_scheme 跳转路径
num - 内部使用
raw_hot hot_value 热度值
rank rank 排名
note note 摘要
label_name label 标签
flag flag 有效性
- url PC 端搜索 URL
- detail_url 移动端详情 URL

生成时间: 2026-03-29