---
title: "微博 API 文档与接口目录"
description: "微博第三方数据 API 文档：按关键词和时间搜索帖子，读取帖子详情、评论和账号内容；含 ID/MID 区分、分页说明及 Python 接入教程。"
---

# 微博 API 文档与接口目录

JustOneAPI 提供第三方微博数据 API，用于话题研究、舆情监测和账号内容分析。按已有的关键词、帖子 ID、MID 或 UID 选择下方接口。

## 按任务选择微博数据接口

- 查找话题帖子：[关键词搜索 V2](./keyword-search-v2)需要 `q`、`startDay`、`endDay`、`startHour` 和 `endHour`。继续分页时使用 `page`，保持同一搜索条件。
- 查询已知帖子：[帖子详情 V1](./post-details-v1)接收 `id`。
- 读取评论讨论：[帖子评论 V1](./post-comments-v1)接收 `mid`；[评论回复 V1](./comment-replies-v1)接收 `commentId`。两者均支持可选 `maxId` 分页，各自保留对应请求流程的游标。
- 研究账号内容：使用 `uid` 查看[用户资料 V3](./user-profile-v3)或[用户发布帖子 V1](./user-published-posts-v1)。继续翻页前核对接口页的续页参数。
- 发现当前话题：[热搜 V1](./hot-search-v1)提供当前微博热搜排名。

## 串联搜索、详情与评论

阅读已有的[按时间搜索帖子、获取详情与评论 Python 教程](https://justoneapi.com/zh/blog/weibo-search-post-comments-api-tutorial)，查看 ID/MID 关联、评论游标、去重和有限结果的 JSON 保存流程。

详情接口的 `id` 与评论接口的 `mid` 是不同入参，不自行假定可以互换；搜索页码与评论游标分别管理。有限的搜索或评论样本不代表已覆盖某个话题或讨论的全部内容。

## 认证与调用范围

认证方式请阅读[API 使用指南](../../usage)。接口权限、价格及可用试用额度以控制台为准。本目录介绍读取数据的接口，不提供发帖、点赞或账号登录接口。

## 可用接口

<div class="api-doc-table api-doc-table--platform">

| 接口 | 方法 | 说明 |
| --- | --- | --- |
| [关键词搜索 \(V2\)](./keyword-search-v2) | `GET` | 通过关键词在所需的小时日时间范围内搜索微博帖子，支持基于页码的分页、热门或时间排序，以及图片、视频、音乐或链接的筛选。用于查找有时间限制的帖子，以进行话题研究或监控。 |
| [帖子详情 \(V1\)](./post-details-v1) | `GET` | 检索通过帖子ID标识的微博帖子详情。用于查找已知帖子，以进行内容审查、存档或相关互动分析。 |
| [用户资料 \(V3\)](./user-profile-v3) | `GET` | 检索通过UID标识的微博用户资料。用于查找已知账号，以进行创作者研究、资料审查或后续检索该用户的帖子和视频。 |
| [用户粉丝 \(V1\)](./user-fans-v1) | `GET` | 检索由UID标识的微博用户的粉丝账号页面。用于浏览该账号的粉丝受众或继续翻阅粉丝列表。 |
| [用户关注者 \(V1\)](./user-followers-v1) | `GET` | 检索由UID标识的微博用户关注的账号页面。用于检查该账号的关注网络或继续翻阅关注列表。 |
| [用户发布帖子 \(V1\)](./user-published-posts-v1) | `GET` | 检索由UID标识的微博用户发布的帖子，使用页码和第一页后必需的sinceId游标。用于浏览账号的发布历史或继续翻阅帖子feed。 |
| [用户视频列表 \(V1\)](./user-video-list-v1) | `GET` | 检索由UID标识的微博用户的视频瀑布流，可使用先前响应中的可选游标。用于浏览已知账号发布的视频或继续翻阅视频feed。 |
| [电视视频详情 \(V1\)](./tv-video-details-v1) | `GET` | 检索由冒号分隔的对象ID (OID) 标识的微博TV视频详情。用于查找已知的TV视频以进行内容审核、编目或后续处理。 |
| [热搜 \(V1\)](./hot-search-v1) | `GET` | 检索当前的微博热搜排名。用于识别热门话题以进行新闻监测、内容规划或及时话题发现。 |
| [帖子评论 \(V1\)](./post-comments-v1) | `GET` | 检索由MID标识的微博帖子的评论，支持可选的maxId游标分页以及时间或热度排序。用于查看受众讨论、继续翻阅评论区或支持审核和反馈分析。 |
| [评论回复 \(V1\)](./comment-replies-v1) | `GET` | 检索由 commentId 标识的微博一级评论下的回复，支持可选的 maxId 游标分页。用于追踪评论串以进行讨论研究或反馈分析。 |
| [搜索用户发布帖子 \(V1\)](./search-user-published-posts-v1) | `GET` | 搜索特定微博用户发布的帖子，使用关键词、可选的日期范围和基于页面的分页。用于从已知账号查找历史帖子以进行话题研究或活动回顾。 |

</div>

