Weibo Hot Search
Retrieve the current Weibo hot-search ranking, including trending search terms and popularity information. Inputs (all optional): - category: Ranking category. Default: realtimehot. Documented values: mineband (My hot search), realtimehot (real-time hot search), social (society), fun (entertainment), technologynav (technology), lifenav (lifestyle), region (local), sportnav (sports), and gamenav (ACG). - page: Integer page number starting at 1; default 1. - count: Integer number of items per page, from 1 to 50; default 20. - region_name: City name, effective only when category=region; defaults to 北京 (Beijing). Supported names include 北京, 上海, 广州, 深圳, 杭州, 成都, 重庆, 武汉, 南京, 天津, 西安, 长沙, 郑州, 苏州, 东莞, 青岛, 沈阳, and 合肥. Returns ranking data for the requested category and page. The detailed data structure is not specified. Rankings update over time, so results may differ between requests. Example: category="region", region_name="上海", page=1, count=20.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
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 |
|---|---|---|---|---|
page | integer | No | 页码 | 1 |
count | integer | No | 每页数量 | 20 |
category | string | No | 热搜分类: mineband=我的, realtimehot=热搜, social=社会, fun=文娱, technologynav=科技, lifenav=生活, region=同城, sportnav=体育, gamenav=ACG | realtimehot |
region_name | string | No | 同城热搜城市名称,仅 category=region 时有效,支持: 北京/上海/广州/深圳/杭州/成都/重庆/武汉/南京/天津/西安/长沙/郑州/苏州/东莞/青岛/沈阳/合肥等,默认北京 | — |
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_hot_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"category": "realtimehot",
"count": 30
}
}'{
"code": 200,
"data": {
"channelInfo": {
"channelConfig": {
"auto_refresh_config": {
"106003_-_type:25_-_filter_type:mineband": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
},
"106003type=25&t=3&disable_hot=1&filter_type=fun": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
},
"106003type=25&t=3&disable_hot=1&filter_type=gamenav": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
},
"106003type=25&t=3&disable_hot=1&filter_type=lifenav": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
},
"106003type=25&t=3&disable_hot=1&filter_type=realtimehot": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
},
"106003type=25&t=3&disable_hot=1&filter_type=region": {
"page_resume_expire_sec": 80000,
"tab_and_background_expire_min": 1
}
},
"refresh_configs": {
"106003_-_type:25_-_filter_type:mineband": 1,
"106003type=25&t=3&disable_hot=1&filter_type=fun": 1,
"106003type=25&t=3&disable_hot=1&filter_type=gamenav": 1,
"106003type=25&t=3&disable_hot=1&filter_type=lifenav": 1,
"106003type=25&t=3&disable_hot=1&filter_type=realtimehot": 1,
"106003type=25&t=3&disable_hot=1&filter_type=region": 1
},
"selectInfo": {
"flowId": "106003type=25&t=3&disable_hot=1&filter_type=realtimehot",
"pageDataType": "flow",
"tabKey": "commonPage"
}
},
"channels": [
{
"actionlog": {
"act_code": 554,
"act_type": 1,
"ext": "seqid:17941839058290347660592|srid:abe6d7d3908051170f25bf0e63b47841|lcate:1001|nav_tab:mineband|c_type:31|qtime:1794183905|t:31|cate:5092|page:1|type:25|dgr:0",
"fid": "106003type=25&t=3&disable_hot=1&filter_type=realtimehot",
"lfid": "102803_ctg1_1780_-_ctg1_1780",
"luicode": "10000512"
},
"apiPath": "flowpage",
"containerid": "106003_-_type:25_-_filter_type:mineband",
"flowId": "106003_-_type:25_-_filter_type:mineband",
"pageDataType": "flow",
"title": "我的"
}
]
},
"refreshInfo": "{}"
},
"docs": "https://api.tikhub.io/#/Weibo-App-API/fetch_hot_search_api_v1_weibo_app_fetch_hot_search_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

