微博高级搜索/Weibo Advanced Search

功能说明/Function Description

提供微博高级搜索功能，支持按类型、内容包含、时间范围等多维度筛选搜索结果。/Provides Weibo advanced search functionality with multi-dimensional filtering by type, content inclusion, time range, etc.

🔍 搜索参数/Search Parameters

1️⃣ 搜索类型/Search Type（search_type）

all: 全部类型/All types

hot: 热门排序/Hot sorting

original: 原创内容/Original content

verified: 认证用户/Verified users

media: 媒体类型/Media type

viewpoint: 观点类型/Viewpoint type

2️⃣ 包含类型/Include Type（include_type）

all: 包含全部内容/Include all content

pic: 含图片的微博/Posts with pictures

video: 含视频的微博/Posts with videos

music: 含音乐的微博/Posts with music

link: 含短链的微博/Posts with links

3️⃣ 时间范围/Time Range（timescope）

格式/Format: custom:开始时间:结束时间/custom:start_time:end_time

示例/Examples:

custom:2025-09-08:                    # 只选开始日期/Start date only
custom:2025-09-08-0:                  # 开始日期+时间(小时)/Start date + hour
custom:2025-09-08-0:2025-09-08        # 开始日期到结束日期/Start to end date
custom:2025-09-08-0:2025-09-08-23     # 完整时间范围/Complete time range

参数说明/Parameter Description

q (必填/Required): 搜索关键词/Search keyword

类型/Type: 字符串/String

示例/Example: "yu7"

说明/Description: 要搜索的关键词或话题/Keywords or topics to search

search_type (可选/Optional): 搜索类型/Search type

类型/Type: 字符串/String (枚举/Enum)

可选值/Options: all, hot, original, verified, media, viewpoint

示例/Example: "hot"

include_type (可选/Optional): 包含类型/Include type

类型/Type: 字符串/String (枚举/Enum)

可选值/Options: all, pic, video, music, link

示例/Example: "pic"

timescope (可选/Optional): 时间范围/Time scope

类型/Type: 字符串/String

格式/Format: custom:start:end

示例/Example: "custom:2025-09-01-0:2025-09-08-23"

page (可选/Optional): 页码/Page number

类型/Type: 整数/Integer

默认值/Default: 1

示例/Example: 1

🎯 使用示例/Usage Examples

# 搜索热门内容/Search hot content
GET /fetch_advanced_search?q=python&search_type=hot

# 搜索含图片的原创内容/Search original content with images
GET /fetch_advanced_search?q=编程&search_type=original&include_type=pic

# 按时间范围搜索/Search by time range
GET /fetch_advanced_search?q=AI&timescope=custom:2025-09-01-0:2025-09-08-23

# 分页搜索/Paginated search
GET /fetch_advanced_search?q=科技&page=2&search_type=hot

返回数据结构/Return Data Structure

{
  "code": 200,
  "data": {
    "parsed_data": {
      "results": [
        {
          "weibo_id": "微博MID",
          "user_name": "发布者用户名",
          "user_url": "用户主页链接",
          "user_nick": "昵称(可选)",
          "user_avatar": "头像(可选)",
          "publish_time": "发布时间",
          "post_url": "微博链接",
          "content": "微博内容文本",
          "media": {
            "has_image": true,
            "images": [
              "https://...jpg"
            ],
            "has_video": true,
            "videos": [
              {
                "type": "video",
                "src": "https://f.video.weibocdn.com/...mp4?...",
                "streams": [
                  "https://f.video.weibocdn.com/...720p.mp4?...",
                  "https://f.video.weibocdn.com/...480p.mp4?..."
                ],
                "poster": "https://...jpg",
                "duration": "02:02",
                "page_url": "https://video.weibo.com/show?fid=1034:...",
                "fid": "1034:..."
              }
            ]
          },
          "interaction": {
            "repost_count": 12,
            "comment_count": 34,
            "like_count": 56
          }
        }
      ],
      "result_count": 10,
      "pagination": {
        "current_page": 1,
        "has_next_page": true,
        "next_page_url": "https://s.weibo.com/...&page=2"
      },
      "search_stats": {
        "search_stats": "搜索统计信息"
      },
      "parse_success": true
    }
  }
}

关键字段说明：

media.videos[].src：主视频直链（可能为 CDN mp4），已规范化为 https。

media.videos[].streams：候选视频直链列表，包含不同清晰度/来源的 mp4。

media.videos[].poster：视频封面图（若能解析）。

media.videos[].duration：视频时长文本（如 02:02）。

media.videos[].page_url：视频的播放页地址（兜底）。

media.videos[].fid：微博视频 fid（兜底解析）。

注意事项/Notes

视频需要设置合适的请求头（Referer=https://weibo.com/）才能播放。

使用场景/Use Cases

精确搜索/Precise Search: 按特定条件筛选微博内容/Filter Weibo content by specific criteria

内容分析/Content Analysis: 获取特定类型的微博进行分析/Get specific types of Weibo for analysis

媒体监控/Media Monitoring: 监控特定话题的媒体报道/Monitor media coverage of specific topics

趋势研究/Trend Research: 分析特定时间段的话题热度/Analyze topic trends in specific time periods

用户行为研究/User Behavior Research: 研究认证用户的发布行为/Study verified users' posting behavior

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

微博高级搜索/Weibo Advanced Search