---
document_id: agent.collection.task.weibo_search_posts_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Search posts / 搜索帖子

Search Weibo posts by keyword. For one post's details use weibo_status_detail_v1; for its comments use weibo_status_comments_v1.

按关键词搜索微博帖子。要取某条微博的详情用 weibo_status_detail_v1，要取评论用 weibo_status_comments_v1。

Task / 任务: `weibo_search_posts_v1`
Platform / 平台: Weibo / 微博
Billing / 计费: 3 Credits per successful task / 每个成功任务 3 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Inputs / 输入

- `keyword` — Keyword / 关键词; kind=text; required=True; default=''; bounds=min_length=1, max_length=100
- `search_type` — Search scope / 搜索范围; kind=select; required=False; default='all'; allowed=all, hot, original, verified, media, viewpoint
- `include_type` — Content type / 内容类型; kind=select; required=False; default='all'; allowed=all, pic, video, music, link
- `timescope` — Time range / 时间范围; kind=text; required=False; default='all'; bounds=min_length=0, max_length=64
- `page` — Page / 页码; kind=integer; required=False; default=1; bounds=min=1, max=50

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "搜索微博上关于扫地机器人的帖子",
  "task_code": "weibo_search_posts_v1",
  "input": {
    "keyword": "扫地机器人"
  }
}
```


## Result and pagination / 结果与分页

- mode=page
- current page: `data.page`; next-page hint: `data.next_page`

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.items` — type=array<object>; Weibo posts returned by this page. / 本页返回的微博帖子。
- `data.item_count` — type=integer; Number of posts in this page. / 本页帖子数。
- `data.page` — type=integer|null; Current result page when supplied. / 当前结果页（如响应提供）。
- `data.has_more` — type=boolean; Whether another page is available with a safe page number. / 是否还有可用安全页码的下一页。
- `data.next_page` — type=integer|null; Next page number to pass back to this task when has_more is true. / has_more 为 true 时传回本任务的下一页页码。
- `data.items[].status_id` — type=string; Weibo post identifier. / 微博帖子 ID。
- `data.items[].text` — type=string; Post text. / 帖子正文。
- `data.items[].published_at` — type=integer|null; Publication time as Unix seconds. / 以 Unix 秒表示的发布时间。
- `data.items[].repost_count` — type=integer|null; Repost count. / 转发数。
- `data.items[].comment_count` — type=integer|null; Comment count. / 评论数。
- `data.items[].like_count` — type=integer|null; Like count. / 点赞数。
- `data.items[].author_id` — type=string|null; Author identifier. / 作者 ID。
- `data.items[].author_name` — type=string|null; Author display name. / 作者名称。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。