Xiaohongshu Search Groups
Search Xiaohongshu group chats by keyword, with support for pagination. Inputs: - keyword (required): Search term, such as "上海". - page_no (optional, default 0): Page number, starting at 0. - search_id (optional, default ""): Leave empty for the first request; it is generated automatically. For later pages, reuse the search_id returned by the first search. - source (optional, default "unifiedSearchGroup"): Search source. - is_recommend (optional, default 0): Recommendation flag; 0 means no and 1 means yes. Returns: Search result data containing a group list and pagination information. Individual group record fields are not specified. To paginate, start with page_no=0 and an empty search_id, then increment page_no while reusing the first search's search_id. This tool finds groups; it does not join them or read their chat messages.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
source | string | No | 来源/Source | unifiedSearchGroup |
keyword | string | Yes | 搜索关键词/Search keyword | — |
page_no | integer | No | 页码,从0开始/Page number, start from 0 | 0 |
search_id | string | No | 搜索ID,翻页时传入首次搜索返回的值/Search ID for pagination | "" |
is_recommend | integer | No | 是否推荐:0=否, 1=是/Is recommend: 0=no, 1=yes | 0 |
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_xiaohongshu_search_groups' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "爱媛团购",
"page_no": 0
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"group_info_list": [
{
"active_info": {
"last_active_time": 0,
"last_seven_day_active_user_num": 0,
"last_seven_day_msg_num": 0,
"yesterday_active_user_num": 0
},
"allow_group_map": true,
"avatar": "https://msg-img.xhscdn.com/im-avatar/6a31d1e0b33fce0015349e75.png?imageView2/2/w/400/format/png",
"create_time": 1698231403000,
"group_creator_id": "5eeead0a00000000010031f4",
"group_desc": "四川产地维C水果团购:红心猕猴桃、爱媛果冻橙、春见耙耙柑、不知火丑橘、明日见柑橘团购群!"
}
],
"group_search_filters": [
{
"id": "order_by",
"name": "Sort by",
"options": [
{}
]
}
],
"has_more": false
},
"debug_id": "451d4f90",
"debug_info": "gAAAAABq-gdz2D354tvqMa3Q7sDXPP5TOnmpFFcWFskTxKqr80tZQdUMt-qS6dAfeZkaLBZR7cyayKmZcu-wLredhfh9yowKBvtfYHyI9xXc3E60jFQL-BsXR0ijJRv6oYqnXh8OT0FDnHE07Npy_1psomOveOAcSNNls-TAOQPUiRuP4Whx7pCzlHHOGZjDS5XGqUqjzTH4DrJ_J7SL4xOyhO4cx1T4Nm_Bb1v7XGnEsJwmQwtYr3VDk1jHQ9Si",
"msg": "成功",
"success": true
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-App-V2-API/search_groups_api_v1_xiaohongshu_app_v2_search_groups_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"is_recommend": "0",
"keyword": "爱媛团购",
"page_no": "0",
"search_id": "",
"source": "unifiedSearchGroup"
}
}This example shows part of the response. Copied content is valid JSON.

