Baidu Tieba List Forum Posts
Browse posts in a Baidu Tieba forum without a search keyword. Provide request_body containing the required, nonempty forum_name: use the exact forum name (for example, 方便面), without appending 吧, URL-encoding it, or supplying a URL or numeric ID. Optional sort_type is default, newest, latest_reply, or hot; Tieba determines the actual order, which is not guaranteed to be strictly chronological. featured_only defaults to false (no featured-only filter). When true, sort_type must be default. Pagination is token-based only, with no page-number or page-size input. Leave page_token empty initially, then pass next_page_token unchanged with the same forum_name, sort_type, and featured_only. Clear the token when changing sorting or filtering, and never use a token from another forum or operation. An empty next_page_token marks the end of the currently readable list, regardless of item count. The query returns items and next_page_token directly. Post items include IDs, titles, authors, summaries, images/videos, links, forum information, publication and latest-reply times, engagement counts, and pinned status. Summaries are not full text; media may be incomplete and links may expire. Unavailable times and view counts are null; available times are Unix seconds. Ordinary and pinned posts may appear, with no guarantee of deduplication across pages or complete historical coverage. A code/message business error may be returned instead of success data; do not treat HTTP 200 alone as success.
Pricing
| Condition | Charge |
|---|---|
| Each call | 28.01 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 帖子列表查询条件;forum_name 必填,可设置排序、精华筛选和分页令牌。 | — |
request_body.sort_type | enum (default | newest | latest_reply | hot) | No | 排序方式:default 为贴吧默认顺序,newest 为最新发布,latest_reply 为最近回复,hot 为热门。顺序以贴吧实际返回为准,不保证严格按时间排列;仅查看精华时只支持 default。 | default |
request_body.forum_name | string | Yes | 准确贴吧名称,例如 方便面;直接使用结果中的 forum_name,不要自行追加“吧”字;不要传 URL 或数字 ID,无需 URL 编码。 | — |
request_body.page_token | string | No | 分页令牌;首次留空,续页原样传回 next_page_token,并保持 forum_name、sort_type、featured_only 不变。切换排序或精华筛选时,将 page_token 留空重新查询。只根据令牌判断是否续页,不按条数判断;不要使用其他接口或其他贴吧的令牌。 | "" |
request_body.featured_only | boolean | No | 是否仅查看精华帖,false 表示不筛选(仍可包含精华帖);true 时 sort_type 必须为 default,按贴吧精华列表顺序返回。 | false |
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_baidu_tieba_list_forum_posts' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"forum_name": "xxx"
}
}
}'No response example available yet.

