Weibo Advanced Search

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
qstringYes搜索关键词/Search keyword—
pageintegerNo页码/Page number1
timescopestring | nullNo时间范围/Time scope (custom:start:end)—
search_typestring | nullNo搜索类型/Search type: all(全部), hot(热门), original(原创), verified(认证用户), media(媒体), viewpoint(观点)—
include_typestring | nullNo包含类型/Include type: all(全部), pic(含图片), video(含视频), music(含音乐), link(含短链)—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.