> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 微博常见问题

> 按关键词搜索、热搜榜、单条微博、评论或账号作品选择对应的微博动作。

按词找微博用[关键词搜索](/zh/faq/weibo-keyword-search)，看当天讨论查[热搜](/zh/faq/weibo-hot-search)。已经确定是哪条微博时，用 `weibo.web_v2.fetch_post_detail` 和 `weibo.web_v2.fetch_post_comments` [核对编号并读评论](/zh/faq/weibo-comment-research)。

## 搜索与发现

* [关键词搜索](/zh/faq/weibo-keyword-search)
* [搜索翻页](/zh/faq/weibo-search-pagination)

## 趋势与研究

* [热搜榜](/zh/faq/weibo-hot-search)
* [热搜分类](/zh/faq/weibo-trend-categories)
* [同城热搜](/zh/faq/weibo-local-trends)
* [热搜条数与翻页](/zh/faq/weibo-trend-pagination)

## 链接与对象

* [微博与用户编号](/zh/faq/weibo-identifiers)

## 研究恢复

* [采集中断后继续研究](/zh/faq/weibo-research-recovery)

## 视频与指标

* [视频播放量周报](/zh/faq/weibo-video-metrics)

## 评论与用户问题

* [评论到用户问题](/zh/faq/weibo-comment-research)

## 单帖、评论和账号作品怎么选？

例如要复盘品牌在新品发布后一周收到的质疑，先读选中的官宣原帖和评论，再补同一账号的相关帖子。下面三个动作都向 `POST https://api.beatapi.io/v1/social-data/call` 发请求，使用 BeatAPI Bearer 凭据，JSON 正文写动作和参数。帖子 ID 与账号 UID 是两种编号，分别用[标识说明](/zh/faq/weibo-identifiers)核对。

| 目标       | action                             | params 首次示例                                    |
| -------- | ---------------------------------- | ---------------------------------------------- |
| 读已选帖的长文  | `weibo.web_v2.fetch_post_detail`   | `{"id":"<post_id>","is_get_long_text":"true"}` |
| 抽查该帖的评论  | `weibo.web_v2.fetch_post_comments` | `{"id":"<post_id>","count":10,"max_id":""}`    |
| 查看该账号的作品 | `weibo.web_v2.fetch_user_posts`    | `{"uid":"<uid>","page":1,"feature":0}`         |

每次响应成功后，保存原件、请求 ID 和对象 ID，再核对：

1. `weibo.web_v2.fetch_post_detail` 返回的长文正文已经补齐。
2. `weibo.web_v2.fetch_post_comments` 返回的评论属于目标帖子，原句完整。
3. `weibo.web_v2.fetch_user_posts` 返回的作品作者、发文时间符合要比较的范围。

三个动作暂未登记统一结果数组，按每次实际响应的字段映射。评论翻页传实际返回的 `max_id`；账号作品翻页用 `weibo.web_v2.fetch_user_posts` 支持的 `page` 或实际返回的 `since_id`，两种游标不混用。要先找当日热议，查[热搜](/zh/faq/weibo-hot-search)，选好词再决定要读的帖子。

## 相关内容

[微博 任务指南](/zh/guides/weibo)

## 给已连接工具的助手一个具体任务

> 研究这款耳机固件更新后的公开反馈。先查一批相关微博，保留实际发布时间和型号；摘录不足时只补入选长文，再查看有必要的评论。区分官方公告、转述和用户自述，给每条发现附出处。

助手从搜索预览里挑选微博。需要引用时，助手读取同一次已存结果，或补取那条具体微博。让助手按实际读到的材料交付，并写明覆盖范围。 [操作流程](/zh/guides/weibo-python-research) · [连接和结果阅读](/zh/faq/assistant-social-research)。