Weibo Hot Ranking Timeline
Retrieve popular posts from a Weibo ranking timeline. Inputs: - ranking_type (required string): hour = hourly ranking; yesterday = yesterday's ranking; day_before = the day-before-yesterday ranking; week = weekly ranking; male = male ranking; female = female ranking. - count (optional integer, default 10): requested number of posts. - since_id (optional string, default "0"): pagination identifier. - max_id (optional string, default "0"): pagination cursor; use "0" for the first request. Returns: response data for the selected ranking, containing hot posts with post content, author information, and interaction data where available. The detailed result structure is not fixed by the documented response schema. Example: {"ranking_type":"hour","since_id":"0","max_id":"0","count":10}.
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 |
|---|---|---|---|---|
count | integer | No | 获取数量,默认10/Count, default is 10 | 10 |
max_id | string | No | 最大ID,默认为0/Max ID, default is 0 | 0 |
since_id | string | No | 分页标识,默认为0/Pagination identifier, default is 0 | 0 |
ranking_type | string | Yes | 榜单类型:hour=小时榜,yesterday=昨日榜,day_before=前日榜,week=周榜,male=男榜,female=女榜/Ranking type: hour=hourly, yesterday=yesterday, day_before=day before, week=weekly, male=male ranking, female=female ranking | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_weibo_hot_ranking_timeline' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"ranking_type": "xxx"
}
}'No response example available yet.

