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_bodyobject是搜索请求对象;提供贴吧名称 forum_name 和搜索关键词 keyword,可选排序方式和分页令牌。—
request_body.keywordstring是在指定贴吧中搜索的关键词或短语;不要传帖子链接或分页令牌。—
request_body.sort_typeenum (newest | relevance | relevant)否排序方式:newest 为最新(默认),relevance 为相关;relevant 仅兼容旧调用,新调用请使用 relevance。结果顺序以贴吧返回为准。newest
request_body.forum_namestring是准确贴吧名称,例如 方便面;直接使用结果中的 forum_name,不要自行追加“吧”字;不要传 URL 或数字 ID,无需 URL 编码。—
request_body.page_tokenstring否分页令牌;首次留空,续页原样传入本接口返回的 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
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。