Start building

Xiaohongshu (RED) Image Search

https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-images

Returns image notes and matching post metadata for a specified search keyword. Results include image URLs, engagement metrics, note identifiers, and author information.

Try this APIGet API key
Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 5 optional
Production route

Try the model

Playground

Open playground
Input
Search keyword
Page number, start from 1
Search ID, pass value from first search response for pagination
Search session ID, pass value from first search response for pagination
Source, default "explore_feed"
Word request ID, pass value from first search response for pagination
OutputExample
Responseoutputs · 70.3 KB · 1,355 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "filter_items": [
          {
            "filter_tags": [
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "综合",
                "name": "Top",
                "need_location_info": false,
                "origin_text": "",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "最新",
                "name": "Latest",
                "need_location_info": false,
                "origin_text": "openai",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "硬件",
                "name": "硬件",
                "need_location_info": false,
                "origin_text": "openai硬件",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "音箱",
                "name": "音箱",
                "need_location_info": false,
                "origin_text": "openai音箱",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "风控",
                "name": "风控",
                "need_location_info": false,
                "origin_text": "openai风控",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "手机",
                "name": "手机",
                "need_location_info": false,
                "origin_text": "openai手机",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "亏损",
                "name": "亏损",
                "need_location_info": false,
                "origin_text": "openai亏损",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "入职礼物",
                "name": "入职礼物",
                "need_location_info": false,
                "origin_text": "openai入职礼物",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "键盘",
                "name": "键盘",
                "need_location_info": false,
                "origin_text": "openai键盘",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "访谈",
                "name": "访谈",
                "need_location_info": false,
                "origin_text": "openai访谈",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "发展历程",
                "name": "发展历程",
                "need_location_info": false,
                "origin_text": "openai发展历程",
                "selected": false,
                "show_type": 2
              },
              {
                "icon_tail_url": "",
                "icon_tail_url_night": "",
                "icon_url": "",
                "icon_url_night": "",
                "id": "模型",
                "name": "模型",
                "need_location_info": false,
                "origin_text": "openai模型",
                "selected": false,
                "show_type": 2
              }
            ],
            "group_show_type": 1,
            "id": "filter_hot",
            "name": "热门词",
            "type": "single",
            "word_request_id": "3ab4f4b8-2cde-48e6-ab21-d00e52fd8d2f"
          }
        ],
        "items": [
          {
            "image_info": {
              "fileid": "spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8",
              "height": 1232,
              "need_load_original_image": true,
              "original": "https://sns-na-i11.xhscdn.com/spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=640b75edbc86c4fdb1709dc655d22a48&t=6a86cc2c",
              "trace_id": "spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8",
              "url": "https://sns-na-i11.xhscdn.com/spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=IMGTAB_PRV&sign=640b75edbc86c4fdb1709dc655d22a48&t=6a86cc2c",
              "url_size_large": "https://sns-na-i11.xhscdn.com/spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=640b75edbc86c4fdb1709dc655d22a48&t=6a86cc2c",
              "width": 928
            },
            "note_info": {
              "collected": false,
              "collected_count": 226,
              "comments_count": 47,
              "cover_image_index": 0,
              "desc": "关键词[微笑R]\nlino cut of large crowd of people energetically moves towards a giant squere, each person in the crowd expresses their uniqueness and individuality.    Dressed in vibrant colors, they create a bright and colorful scene, before people a bright light,colorful, textured, patterned, fine art print, --chaos 12 --ar 3:4 --stylize 185 --v 6\n\t\n一大群人气势汹汹地走向一个巨大的广场，人群中的每一个人都表达着自己的独特性和个性。\n\t\n#人工智能[话题]#  #OpenAI[话题]#  #midjourney[话题]#  #midjourney学习[话题]#  #midjourney关键词[话题]#  #户外登山徒步[话题]#  #人潮汹涌[话题]#\n#人潮汹涌你是人间心动[话题]#",
              "liked": false,
              "liked_count": 392,
              "model_type": "image_card",
              "note_id": "65b0a37a000000002c014b93",
              "publish_time": {
                "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png",
                "text": "2024-01-24"
              },
              "shared_count": 0,
              "title": "Midjourney绘图 | 人潮汹涌"
            },
            "share_info": {
              "content": "关键词[微笑R] lino cut of large crowd of people energetically mov",
              "function_entries": [
                {
                  "type": "generate_image"
                },
                {
                  "type": "copy_link"
                },
                {
                  "type": "dislike"
                },
                {
                  "type": "report"
                }
              ],
              "guide_audited": true,
              "image": "http://ci.xiaohongshu.com/spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8?imageView2/2/w/1080/format/jpg",
              "link": "https://www.xiaohongshu.com/discovery/item/65b0a37a000000002c014b93?app_platform=ios&app_version=9.32.2&share_from_user_hidden=true&type=NORMAL",
              "title": "Midjourney绘图 | 人潮汹涌"
            },
            "user_info": {
              "images": "https://sns-avatar-qc.xhscdn.com/avatar/64354610ec2be016c1cf5f6a.jpg?imageView2/2/w/80/format/jpg",
              "nickname": "快乐小欢",
              "red_id": "9549661040",
              "red_official_verified": false,
              "red_official_verify_type": 0,
              "show_red_official_verify_icon": false,
              "user_id": "60b137080000000001000301"
            }
          },
          {
            "image_info": {
              "fileid": "1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o",
              "height": 1130,
              "need_load_original_image": true,
              "original": "https://sns-na-i11.xhscdn.com/1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=358b87929941563754ed2a56a8865e46&t=6a86cc2c",
              "trace_id": "1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o",
              "url": "https://sns-na-i11.xhscdn.com/1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=IMGTAB_PRV&sign=358b87929941563754ed2a56a8865e46&t=6a86cc2c",
              "url_size_large": "https://sns-na-i11.xhscdn.com/1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=358b87929941563754ed2a56a8865e46&t=6a86cc2c",
              "width": 848
            },
            "note_info": {
              "collected": false,
              "collected_count": 49,
              "comments_count": 3,
              "cover_image_index": 0,
              "desc": "2月4日，全球领先的人工智能科技公司 OpenAI 发布了全新的标志和品牌形象。\n.\n本次品牌重塑的设计团队，由 OpenAI 设计主管 Veit Moeller 和 设计总监 Shannon Jager 领导，柏林字体工作室 ABC Dinamo 和荷兰登贝工作室（Studio Dumbar）动效团队也参与了合作。Moeller 曾在梅赛德斯奔驰（Mercedes-Benz）、WhatsApp 和 Instagram 担任创意总监。\n.\n本次品牌重塑旨在打造更加有机、更加人性化的形象，内容包括：\n.\n全新字体 OpenAI Sans，融合几何精度和人性化设计。\n更强调 OpenAI 文字标志，弱化原有“花瓣”标志。\n重新设计的“花瓣”标志，优化几何形态和线条。\n全新配色方案与网格系统，更规范的应用指导。\n“情感点”符号：一个脉动的蓝色圆盘，象征用户与 AI 的互动。\n.\n全新品牌形象，OpenAI 将风格在原来简约的基础上继续往极简靠拢，多余的元素坚决不用。\n.\n#品牌设计[话题]# #logo设计[话题]# #极简设计极尽思考[话题]# #AI人工智能[话题]# #设计灵感[话题]# #VI设计[话题]# #科技品牌设计[话题]# #OpenAI[话题]# #deepseek[话题]# #品牌美[话题]#",
              "liked": false,
              "liked_count": 81,
              "model_type": "image_card",
              "note_id": "67a405de0000000029010942",
              "publish_time": {
                "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png",
                "text": "2025-02-06"
              },
              "shared_count": 0,
              "title": "爱死OpenAI的极简了🖤"
            },
            "share_info": {
              "content": "2月4日，全球领先的人工智能科技公司 OpenAI 发布了全新的标志和品牌形象。 . 本次品牌重塑的设计团队，由 Ope",
              "function_entries": [
                {
                  "type": "generate_image"
                },
                {
                  "type": "copy_link"
                },
                {
                  "type": "dislike"
                },
                {
                  "type": "report"
                }
              ],
              "guide_audited": true,
              "image": "http://ci.xiaohongshu.com/1040g2sg31dhrsvh30kcg5oa8360gkojknkgkc5o?imageView2/2/w/1080/format/jpg",
              "link": "https://www.xiaohongshu.com/discovery/item/67a405de0000000029010942?app_platform=ios&app_version=9.32.2&share_from_user_hidden=true&type=NORMAL",
              "title": "爱死OpenAI的极简了"
            },
            "user_info": {
              "images": "https://sns-avatar-qc.xhscdn.com/avatar/614819810000000002026274.jpg?imageView2/2/w/80/format/jpg",
              "nickname": "品牌美",
              "red_id": "pinpaimei",
              "red_official_verified": false,
              "red_official_verify_type": 0,
              "show_red_official_verify_icon": false,
              "user_id": "614819810000000002026274"
            }
          },
          {
            "image_info": {
              "fileid": "1040g00831fhka8r7g4304a1ftkh09fl657ldq70",
              "height": 1365,
              "need_load_original_image": true,
              "original": "https://sns-na-i11.xhscdn.com/1040g00831fhka8r7g4304a1ftkh09fl657ldq70?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=118dde7a042c4cd489cd83f8838f395c&t=6a86cc2c",
              "trace_id": "1040g00831fhka8r7g4304a1ftkh09fl657ldq70",
              "url": "https://sns-na-i11.xhscdn.com/1040g00831fhka8r7g4304a1ftkh09fl657ldq70?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=IMGTAB_PRV&sign=118dde7a042c4cd489cd83f8838f395c&t=6a86cc2c",
              "url_size_large": "https://sns-na-i11.xhscdn.com/1040g00831fhka8r7g4304a1ftkh09fl657ldq70?imageView2/2/w/5000/h/5000/format/webp/q/90&ap=5&sc=IMGTAB_ZOOM&sign=118dde7a042c4cd489cd83f8838f395c&t=6a86cc2c",
              "width": 1024
            },
            "note_info": {
              "collected": false,
              "collected_count": 378,
              "comments_count": 118,
              "cover_image_index": 0,
              "desc": "4o更新！做了一些卡通版ootd，还得是openai啊\n小猫咪怎么这么可爱！\n\t\n#分享一张可爱动物[话题]# #ChatGPT4o[话题]# #我和AI有话说[话题]# #AI画图[话题]# #分享你的今日穿搭ootd[话题]# #ootd[话题]# #ChatGPT[话题]#",
              "liked": false,
              "liked_count": 1072,
              "model_type": "image_card",
              "note_id": "67e56653000000001d019a34",

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

keyword
string · required
page
integer · optional
search_id
string · optional
search_session_id
string · optional
source
string · optional
word_request_id
string · optional

Access

Provider
Xiaohongshu
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/xiaohongshu/app-v2/search-images
Authentication
Bearer API key

API README

Xiaohongshu (RED) Image Search API

Search for image notes on Xiaohongshu (RED) by supplying a query in keyword. Supports pagination across result sets using page, search_id, word_request_id, and search_session_id.

Use cases

  • Discover image-based notes matching targeted topic keywords.
  • Extract visual content URLs alongside post engagement statistics.
  • Analyze trending community imagery and creator profiles.

Request

curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-images" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "OpenAI"}'

Parameters

NameTypeRequiredDescription
keywordstringYesSearch keyword
pageintegerNoPage number, start from 1
sourcestringNoSource, default "explore_feed"
search_idstringNoSearch ID, pass value from first search response for pagination
word_request_idstringNoWord request ID, pass value from first search response for pagination
search_session_idstringNoSearch session ID, pass value from first search response for pagination

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "data": {
    "items": [
      {
        "image_info": {
          "trace_id": "spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8",
          "url": "https://sns-na-i11.xhscdn.com/spectrum/1040g0k030ua64rtp56005o5h6s4080o1j0fbkl8?…"
        },
        "note_info": {
          "collected_count": 228,
          "comments_count": 49,
          "desc": "关键词[微笑R] lino cut of large crowd of people energetically moves towards a giant squere, ea…",
          "liked_count": 397,
          "model_type": "image_card",
          "note_id": "65b0a37a000000002c014b93"
        },
        "share_info": {
          "content": "关键词[微笑R] lino cut of large crowd of people energetically mov",
          "link": "https://www.xiaohongshu.com/discovery/item/65b0a37a000000002c014b93?app_platform…",
          "title": "Midjourney绘图 | 人潮汹涌"
        },
        "user_info": {
          "nickname": "<user>",
          "red_id": "9549661040",
          "red_official_verified": false,
          "red_official_verify_type": 0,
          "user_id": "<user>"
        }
      }
    ]
  }
}

Notes

  • Pagination starts at 1 using page.
  • Pass search_id, word_request_id, and search_session_id from the initial search response to retrieve subsequent pages.
  • The source parameter defaults to "explore_feed".

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-images
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-images" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "source": "explore_feed",
  "keyword": "OpenAI",
  "search_id": "",
  "word_request_id": "",
  "search_session_id": ""
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Xiaohongshu (RED) Image SearchThis API
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Creator Hot Inspiration Feed
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Inspiration Feed
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Image Note Details
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Note Comments
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Product Detail
Xiaohongshu		$0.01 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Xiaohongshu (RED) Image Search API?

Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-images with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Xiaohongshu (RED) Image Search API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Xiaohongshu (RED) Image Search API accept?

Required: keyword (string). Optional: page (integer), search_id (string), search_session_id (string), source (string) and word_request_id (string). The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) Image Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Xiaohongshu developer account or API key?

No. Xiaohongshu (RED) Image Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.