Xiaohongshu Search Groups

20.65 credits/call
ae_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.

Social
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.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.

ParameterTypeRequiredDescriptionDefault
sourcestringNo来源/SourceunifiedSearchGroup
keywordstringYes搜索关键词/Search keyword—
page_nointegerNo页码,从0开始/Page number, start from 00
search_idstringNo搜索ID,翻页时传入首次搜索返回的值/Search ID for pagination""
is_recommendintegerNo是否推荐:0=否, 1=是/Is recommend: 0=no, 1=yes0

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_xiaohongshu_search_groups' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "爱媛团购",
    "page_no": 0
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.