Weibo Advanced Search
Search Weibo posts by keyword and refine the results with optional filters. Inputs: - q (required string): Search keyword. - search_type (optional string or null): all (all posts), hot (popular), original (original posts), verified (verified users), media (media accounts), or viewpoint (viewpoints). - include_type (optional string or null): all, pic (images), video, music, or link (short links). - timescope (optional string or null): Custom time range in the format custom:start:end, for example custom:2025-09-01-0:2025-09-08-23. - page (optional integer): Results page number; defaults to 1. Returns: A response containing search results in data. Results may include post content, author information, images, videos, and interaction metrics. The exact result structure and available fields can vary; the documented data schema does not specify individual result fields. Note: To play a returned video, the playback request must include Referer: https://weibo.com/. This header is not a search input.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed charge of 2.07 credits/call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | 搜索关键词/Search keyword | — |
page | integer | No | 页码/Page number | 1 |
timescope | string | null | No | 时间范围/Time scope (custom:start:end) | — |
search_type | string | null | No | 搜索类型/Search type: all(全部), hot(热门), original(原创), verified(认证用户), media(媒体), viewpoint(观点) | — |
include_type | string | null | No | 包含类型/Include type: all(全部), pic(含图片), video(含视频), music(含音乐), link(含短链) | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_weibo_advanced_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"page": 1,
"q": "影目",
"search_type": "all",
"timescope": "custom:2026-11-02-0:2026-11-09-23"
}
}'{
"detail": {
"code": 400,
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"request_id": "95b0cafd-abbd-4384-849e-8a80d40877b9"
}
}This example shows part of the response. Copied content is valid JSON.

