Baidu Tieba Search Suggestions
Get Baidu Tieba forum-name autocomplete suggestions and related forum information. Supply the required request_body object with a non-empty keyword string: a forum-name keyword or prefix such as 美食 or 旅行. URLs, IDs, and pagination tokens are not accepted as alternatives; there is no either-or input requirement. This operation does not search posts or users and does not support pagination. A successful response includes items with suggestion text and forums with forum_id (string), forum_name, forum_url, avatar_url, slogan, and member_count. Avatar, slogan, and member count may be null. Each array preserves returned order and may be empty; items and forums are independent and do not necessarily correspond one-to-one. A returned forum_name can be used in a separate forum-detail query or keyword search within that forum. HTTP 200 may instead contain a business error, so do not treat HTTP 200 alone as success.
Pricing
| Condition | Charge |
|---|---|
| Each call | 28.01 credits/call |
Each call has a fixed charge of 28.01 credits.
The number of returned forum-name suggestions and related forums does not affect the charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 请求对象,包含必填的吧名关键词或前缀 keyword。 | — |
request_body.keyword | string | Yes | 吧名关键词或前缀,例如 美食、旅行;不要传贴吧链接、帖子链接、ID 或分页令牌。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_baidu_tieba_search_suggestions' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"keyword": "美食"
}
}
}'{
"forums": [
{
"avatar_url": "http://tiebapic.baidu.com/forum/w%3D120%3Bh%3D120/sign=3af247e21466d0167e199a2aa710bc3a/42166d224f4a20a4450af8e8d6529822720ed08d.jpg?tbpicau=2026-11-27-05_22d7b16389bcc265840cb7fbc0aa44d4",
"forum_id": "40",
"forum_name": "美食",
"forum_url": "https://tieba.baidu.com/f?kw=%E7%BE%8E%E9%A3%9F",
"member_count": 4953170,
"slogan": "食前方丈,水陆杂陈。食甘寝安,食来运转!"
}
],
"items": [
{
"text": "美食的俘虏"
}
]
}This example shows part of the response. Copied content is valid JSON.

