Baidu Tieba Search Posts In Forum

28.01 credits/call
ae_baidu_tieba_search_posts_in_forum

Search Baidu Tieba topic threads by keyword within a specific forum; comments are not searched. Supply request_body with both forum_name and keyword (both required, not either/or). Use the exact forum name, for example 方便面, without appending 吧; do not supply a forum URL or numeric ID, and no URL encoding is needed. keyword must be a term or phrase, not a post URL or pagination token. Optional sort_type accepts newest (default) or relevance; relevant is retained for legacy compatibility. Result order follows Tieba. For the first page, omit page_token or leave it empty. For subsequent pages, copy this interface's next_page_token unchanged and keep forum_name, keyword, and sort_type unchanged. An empty next_page_token marks the end. Only token pagination is exposed, not page numbers or page size; tokens from other search interfaces must not be reused. Results include items and next_page_token. Each item includes the thread ID, title, summary, author information, forum ID/name, post link, publication/update times, likes, shares, and available image/video data. Times are Unix seconds; update_time may be null. Summaries are not full post bodies. Media can be incomplete, empty arrays do not mean the post has no media, and media URLs may expire. Use site-wide post search when no forum restriction is needed.

Social
28.01 credits/call

Pricing

28.01 credits/call
ConditionCharge
Each call28.01 credits/call

Search for topic posts by keyword within a specified Baidu Tieba forum at a fixed fee of 28.01 credits/call.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes搜索请求对象;提供贴吧名称 forum_name 和搜索关键词 keyword,可选排序方式和分页令牌。—
request_body.keywordstringYes在指定贴吧中搜索的关键词或短语;不要传帖子链接或分页令牌。—
request_body.sort_typeenum (newest | relevance | relevant)No排序方式:newest 为最新(默认),relevance 为相关;relevant 仅兼容旧调用,新调用请使用 relevance。结果顺序以贴吧返回为准。newest
request_body.forum_namestringYes准确贴吧名称,例如 方便面;直接使用结果中的 forum_name,不要自行追加“吧”字;不要传 URL 或数字 ID,无需 URL 编码。—
request_body.page_tokenstringNo分页令牌;首次留空,续页原样传入本接口返回的 next_page_token,保持 forum_name、keyword、sort_type 不变;不要使用其他搜索接口的令牌。""

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.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 exampleresponse.json
JSONPartial content
{
  "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一样"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.