Xiaohongshu Search Images

20.65 credits/call
ae_xiaohongshu_search_images

Search Xiaohongshu images by keyword, with a documented page size of 20 results and support for pagination. Inputs: - keyword (required): Search term, for example "壁纸" (wallpaper). - page (optional): Page number, starting at 1; defaults to 1. - source (optional): Search source; defaults to "explore_feed". - search_id, search_session_id, word_request_id (optional): Pagination identifiers; each defaults to an empty string. Leave these unset for the first search. To retrieve later pages, pass all three values from the first search response along with the same keyword and the desired page number. Returns: Image search result data and pagination information. The detailed image data structure is not specified. Example first search: keyword="壁纸", page=1.

ImageSocial
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

Each call has a fixed charge of 20.65 credits. Charges are per query. A successful query is billed even if it returns no results.

Each search page requested counts as one call. Fetching subsequent pages incurs a separate charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNo页码,从1开始/Page number, start from 11
sourcestringNo来源/Sourceexplore_feed
keywordstringYes搜索关键词/Search keyword—
search_idstringNo搜索ID,翻页时传入首次搜索返回的值/Search ID for pagination""
word_request_idstringNo词请求ID,翻页时传入首次搜索返回的值/Word request ID for pagination""
search_session_idstringNo搜索会话ID,翻页时传入首次搜索返回的值/Search session ID for pagination""

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_images' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "国风非遗 简约 设计",
    "page": 1,
    "source": "explore_feed"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "items": [
        {
          "image_info": {
            "fileid": "note_pre_post_uhdr/1040g3r0324itp8f4go005pvd1usj95crcnusr08",
            "height": 4032,
            "live_photo": {},
            "need_load_original_image": true,
            "trace_id": "note_pre_post_uhdr/1040g3r0324itp8f4go005pvd1usj95crcnusr08",
            "width": 3024
          },
          "note_info": {
            "collected": false,
            "collected_count": 1386,
            "comments_count": 59,
            "cover_image_index": 0,
            "desc": "构思打磨很久的原创螺钿作品《瓶安如意》。\n\t\n宝瓶寓意平安,柿子代表事事如意,桂枝自带贵气。\n天然贝母手工拼贴,自带细腻灵动的珠光。\n\t\n老少皆宜,不管是乔迁新居贺礼,还是赠予长辈亲友都很合适,把中式美好的期许藏进画里。\n愿大家岁岁平安,万事称心。\n\t\n#螺钿画[话题]# #非遗手作[话题]# #原创手工[话题]# #事事如意[话题]# #乔迁礼物[话题]# #中式美学[话题]# #非遗螺钿画[话题]# #螺钿工艺[话题]# #玻璃画[话题]#",
            "title": "原创螺钿画|瓶安如意,平安事事皆如意✨"
          },
          "share_info": {
            "content": "构思打磨很久的原创螺钿作品《瓶安如意》。 宝瓶寓意平安,柿子代表事事如意,桂枝自带贵气。 天然贝母手工拼贴,自带细腻灵动",
            "function_entries": [],
            "guide_audited": true,
            "image": "http://ci.xiaohongshu.com/note_pre_post_uhdr/1040g3r0324itp8f4go005pvd1usj95crcnusr08?imageView2/2/w/1080/format/jpg",
            "link": "https://www.xiaohongshu.com/discovery/item/6a96c5470000000011036f4e?app_platform=ios&app_version=9.28.1&share_from_user_hidden=true&type=NORMAL",
            "title": "原创螺钿画|瓶安如意,平安事事皆如意"
          },
          "user_info": {
            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo321qpthtm7k0g5pvd1usj95crsv35su8?imageView2/2/w/80/format/jpg",
            "nickname": "海叙 SEASTORY",
            "red_id": "95406445920",
            "red_official_verified": false,
            "red_official_verify_type": 0,
            "show_red_official_verify_icon": false
          }
        }
      ]
    },
    "success": true
  },
  "docs": "https://api.tikhub.io/#/Xiaohongshu-App-V2-API/search_images_api_v1_xiaohongshu_app_v2_search_images_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "5ec0ae02-dd93-4af5-902b-7c66574881c7"
}

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