Baidu Tieba Search Posts In Forum
28.01积分/次
ae_baidu_tieba_search_posts_in_forum
按关键词搜索指定百度贴吧内的主题帖,不搜索评论。必须提供 request_body,其中 forum_name 和 keyword 均为必填,二者不是二选一。forum_name 使用准确贴吧名称,例如“方便面”,不要自行追加“吧”字,不要传 URL 或数字 ID,无需 URL 编码;keyword 为搜索词或短语,不要传帖子链接或分页令牌。 sort_type 可选 newest(最新,默认)或 relevance(相关);relevant 仅用于兼容旧调用,新调用请使用 relevance,实际顺序以贴吧返回为准。首次调用省略 page_token 或留空;续页原样传入本接口返回的 next_page_token,并保持 forum_name、keyword、sort_type 不变。next_page_token 为空表示没有更多结果。当前仅支持令牌分页,不提供页码或每页条数参数,也不要混用其他搜索接口的令牌。 结果包含 items 和 next_page_token。每条结果包含主题帖 ID、标题、摘要、作者信息、所属吧 ID/名称、帖子链接、发帖及更新时间、点赞数、分享数,以及可用的图片和视频信息。时间为秒级 Unix 时间戳,update_time 可能为 null。摘要不是完整正文;图片、视频可能不完整,空数组不代表帖子没有对应媒体,媒体链接可能有有效期。不限定贴吧的检索应使用全站帖子搜索。
28.01积分/次
价格说明
28.01积分/次
| 条件 | 费用 |
|---|---|
| 每次调用 | 28.01积分/次 |
在指定贴吧内按关键词搜索主题帖,每次固定费用为28.01积分/次。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
request_body | object | 是 | 搜索请求对象;提供贴吧名称 forum_name 和搜索关键词 keyword,可选排序方式和分页令牌。 | — |
request_body.keyword | string | 是 | 在指定贴吧中搜索的关键词或短语;不要传帖子链接或分页令牌。 | — |
request_body.sort_type | enum (newest | relevance | relevant) | 否 | 排序方式:newest 为最新(默认),relevance 为相关;relevant 仅兼容旧调用,新调用请使用 relevance。结果顺序以贴吧返回为准。 | newest |
request_body.forum_name | string | 是 | 准确贴吧名称,例如 方便面;直接使用结果中的 forum_name,不要自行追加“吧”字;不要传 URL 或数字 ID,无需 URL 编码。 | — |
request_body.page_token | string | 否 | 分页令牌;首次留空,续页原样传入本接口返回的 next_page_token,保持 forum_name、keyword、sort_type 不变;不要使用其他搜索接口的令牌。 | "" |
调用示例
复制请求代码,查看对应的返回示例。
POST
/agent-api/v1/tool/executeX-Api-Key请求代码request.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_baidu_tieba_search_posts_in_forum' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"forum_name": "摩托车",
"keyword": "NX500",
"sort_type": "newest"
}
}
}'返回示例response.json
{
"items": [
{
"author": {
"avatar_url": "https://gss0.bdstatic.com/6LZ1dD3d1sgCo2Kml5_Y_D3/sys/portrait/item/tb.1.74bfcd93.JJ_Pe7Ux20unHI1NxaZYCw?t=1783615996",
"name": "怎么会穷成这样",
"profile_url": "https://tieba.baidu.com/home/main?id=tb.1.74bfcd93.JJ_Pe7Ux20unHI1NxaZYCw%3Ft%3D1783615996&fr=frs",
"user_id": "6985920155"
},
"forum_id": "21748",
"forum_name": "摩托车",
"images": [
{
"url": "https://tiebapic.baidu.com/forum/pic/item/6747b07eca8065381c428e1bd1dda144ac3482e6.jpg?tbpicau=2026-11-23-05_55eb885264ecc269602e3af3444b4309"
}
],
"like_count": 12,
"title": "NX500骑了两千公里,腻了,感觉和之前骑DL250一样"
}
]
}返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。

