Start building

Xiaohongshu (RED) Note Search

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

Search Xiaohongshu (RED / Little Red Book) notes by keyword and get titles, authors, cover images and like, collect, comment and share counts, with sort, note-type and time filters.

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

Try the model

Playground

Open playground
Input
AI mode, 0=off, 1=on
Search keyword
Note type filter
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
Sort type
Source, default "explore_feed"
Time filter
OutputExample
Responseoutputs · 192.8 KB · 4,040 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "ai_mode_enable": false,
        "can_cut": false,
        "cur_cut_number": 0,
        "dqa_authorized_user_by_shared": false,
        "dqa_instant_sid": "d0KrngIV2V",
        "is_broad_query": true,
        "items": [
          {
            "mix_track_id": "NOTE__6a818c80000000003302c0c4__ee63929105554d24__OpenAI",
            "model_type": "note",
            "new_help_style": false,
            "note": {
              "advanced_widgets_groups": {
                "groups": [
                  {
                    "fetch_types": [
                      "guos_test",
                      "note_next_step",
                      "second_jump_bar",
                      "cooperate_binds",
                      "note_collection",
                      "rec_next_infos",
                      "image_stickers",
                      "image_filters",
                      "product_review",
                      "related_search",
                      "cooperate_comment_component",
                      "image_goods_cards",
                      "ads_goods_cards",
                      "ads_comment_component",
                      "goods_card_v2",
                      "image_template",
                      "buyable_goods_card_v2",
                      "ads_engage_bar",
                      "challenge_card",
                      "cooperate_engage_bar",
                      "guide_post",
                      "pgy_comment_component",
                      "pgy_engage_bar",
                      "bar_below_image",
                      "aigc_collection",
                      "co_produce",
                      "widgets_ndb",
                      "next_note_guide",
                      "pgy_bbc_exp",
                      "async_group",
                      "super_activity",
                      "widgets_enhance",
                      "music_player",
                      "soundtrack_player"
                    ],
                    "mode": 1
                  },
                  {
                    "fetch_types": [
                      "guos_test",
                      "vote_stickers",
                      "bullet_comment_lead",
                      "note_search_box",
                      "interact_pk",
                      "interact_vote",
                      "guide_heuristic",
                      "share_to_msg",
                      "follow_guide",
                      "note_share_prompt_v1",
                      "sync_group",
                      "group_share",
                      "share_guide_bubble",
                      "widgets_share",
                      "guide_navigator"
                    ],
                    "mode": 0
                  }
                ]
              },
              "click_score": 0.23010969161987305,
              "collected": false,
              "collected_count": 4,
              "comments_count": 0,
              "corner_tag_info": [
                {
                  "icon": "",
                  "location": -1,
                  "style": 0,
                  "text": "RAGQ9cSiIlL40KiG/B2+BeCOL641ik4+WFewIeW4v+4h8kYBxvlzLGKcryvYmDsf1zV0dJxPUWxZF8s8ePIP7NoMa1j7TzlIdd",
                  "text_en": "",
                  "type": "ubt_sig_token"
                }
              ],
              "cover_image_index": 0,
              "debug_info_str": "",
              "desc": "全球顶级生成式AI巨头扩招，总部核心AppliedAI团队加码旧金山湾区，定向面向美本美硕在读开放岗位，项目经历匹配者优",
              "extract_text_enabled": 0,
              "geo_info": {
                "distance": ""
              },
              "has_music": false,
              "id": "6a818c80000000003302c0c4",
              "images_list": [
                {
                  "fileid": "notes_pre_post/1040g3k8323u6jcmt7acg5qftbbbg8v00gjiil80",
                  "height": 1410,
                  "need_load_original_image": false,
                  "original": "",
                  "trace_id": "notes_pre_post/1040g3k8323u6jcmt7acg5qftbbbg8v00gjiil80",
                  "url": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k8323u6jcmt7acg5qftbbbg8v00gjiil80?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=5ba3099e14215a8ac40b0392d41e58fb&t=6a86cbb8",
                  "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k8323u6jcmt7acg5qftbbbg8v00gjiil80?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=5ba3099e14215a8ac40b0392d41e58fb&t=6a86cbb8",
                  "width": 1116
                }
              ],
              "interaction_area": {
                "status": false,
                "text": "6",
                "type": 1
              },
              "last_update_time": 0,
              "liked": false,
              "liked_count": 6,
              "nice_count": 0,
              "niced": false,
              "note_attributes": [],
              "result_from": "",
              "shared_count": 4,
              "tag_info": {
                "title": "",
                "type": ""
              },
              "timestamp": 1786903920,
              "title": "🇺🇸OpenAI湾区：We're hiring",
              "type": "normal",
              "update_time": 1786903920000,
              "user": {
                "followed": false,
                "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo323fqddc0nu6g5qftbbbg8v00bietpj8?imageView2/2/w/80/format/jpg",
                "nickname": "Delia",
                "red_id": "49338218856",
                "red_official_verified": false,
                "red_official_verify_type": 0,
                "show_red_official_verify_icon": false,
                "track_duration": 0,
                "userid": "69fd5ad70000000001007c00"
              },
              "widgets_context": "{\"flags\":{},\"author_id\":\"69fd5ad70000000001007c00\",\"author_name\":\"Delia\"}",
              "xsec_token": "YBOAIA50BFzVbnly2rjKCrOFV8EqhxEJBum7g0VIzKjCE="
            }
          },
          {
            "mix_track_id": "NOTE__6a6c688000000000060041d4__ee63929105554d24__OpenAI",
            "model_type": "note",
            "new_help_style": false,
            "note": {
              "advanced_widgets_groups": {
                "groups": [
                  {
                    "fetch_types": [
                      "guos_test",
                      "note_next_step",
                      "second_jump_bar",
                      "cooperate_binds",
                      "note_collection",
                      "rec_next_infos",
                      "image_stickers",
                      "image_filters",
                      "product_review",
                      "related_search",
                      "cooperate_comment_component",
                      "image_goods_cards",
                      "ads_goods_cards",
                      "ads_comment_component",
                      "goods_card_v2",
                      "image_template",
                      "buyable_goods_card_v2",
                      "ads_engage_bar",
                      "challenge_card",
                      "cooperate_engage_bar",
                      "guide_post",
                      "pgy_comment_component",
                      "pgy_engage_bar",
                      "bar_below_image",
                      "aigc_collection",
                      "co_produce",
                      "widgets_ndb",
                      "next_note_guide",
                      "pgy_bbc_exp",
                      "async_group",
                      "super_activity",
                      "widgets_enhance",
                      "music_player",
                      "soundtrack_player"
                    ],
                    "mode": 1
                  },
                  {
                    "fetch_types": [
                      "guos_test",
                      "vote_stickers",
                      "bullet_comment_lead",
                      "note_search_box",
                      "interact_pk",
                      "interact_vote",
                      "guide_heuristic",
                      "share_to_msg",
                      "follow_guide",
                      "note_share_prompt_v1",
                      "sync_group",
                      "group_share",
                      "share_guide_bubble",
                      "widgets_share",
                      "guide_navigator"
                    ],
                    "mode": 0
                  }
                ]
              },
              "click_score": 0.20319239795207977,
              "collected": false,
              "collected_count": 67,
              "comments_count": 44,
              "corner_tag_info": [
                {
                  "icon": "",
                  "location": -1,
                  "style": 0,
                  "text": "RAdtYqP8ddxjXPPOtHPLpDF4OiFFf1ysWmnF3GtJfTH3em2TtOsaWjbphXbc4E+m2xOain3B6jB80A0EQGAn1eUXL9MAD6ecyk",
                  "text_en": "",
                  "type": "ubt_sig_token"
                }
              ],
              "cover_image_index": 0,
              "debug_info_str": "",
              "desc": "🇺🇸刚结束OpenAI Machine Learning Engineer面试，最大的感受是：这场面试考察的并不是会",
              "extract_text_enabled": 0,
              "geo_info": {
                "distance": ""
              },
              "has_music": false,
              "id": "6a6c688000000000060041d4",
              "images_list": [
                {
                  "fileid": "spectrum/1040g34o3239hvpqj701g5pon4eqne2i9a7t4538",
                  "height": 1447,
                  "need_load_original_image": false,
                  "original": "",
                  "trace_id": "spectrum/1040g34o3239hvpqj701g5pon4eqne2i9a7t4538",
                  "url": "https://sns-na-i11.xhscdn.com/spectrum/1040g34o3239hvpqj701g5pon4eqne2i9a7t4538?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=120f934430919b7e825be4ebaff4a07f&t=6a86cbb8",
                  "url_size_large": "https://sns-na-i11.xhscdn.com/spectrum/1040g34o3239hvpqj701g5pon4eqne2i9a7t4538?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=120f934430919b7e825be4ebaff4a07f&t=6a86cbb8",
                  "width": 1087
                },
                {
                  "fileid": "spectrum/1040g0k03239hvt6v70005pon4eqne2i9a3v5un8",
                  "height": 1660,
                  "need_load_original_image": false,
                  "original": "",
                  "trace_id": "spectrum/1040g0k03239hvt6v70005pon4eqne2i9a3v5un8",
                  "url": "",
                  "url_size_large": "https://sns-na-i11.xhscdn.com/spectrum/1040g0k03239hvt6v70005pon4eqne2i9a3v5un8?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=f8a11a9101758948184f134624a44af3&t=6a86cbb8",
                  "width": 1242
                }
              ],
              "interaction_area": {
                "status": false,
                "text": "80",
                "type": 1
              },
              "last_update_time": 0,
              "liked": false,
              "liked_count": 80,
              "nice_count": 0,
              "niced": false,
              "note_attributes": [],
              "result_from": "",
              "shared_count": 21,
              "tag_info": {
                "title": "",
                "type": ""
              },
              "timestamp": 1785489536,
              "title": "我发现我真的很会面OpenAI的MLE（已上岸",
              "type": "normal",
              "update_time": 1785846718000,
              "user": {
                "followed": false,
                "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31joi7ebm3q6g5pon4eqne2i96v6tsg0?imageView2/2/w/80/format/jpg",
                "nickname": "Ida Career",
                "red_id": "63034691881",
                "red_official_verified": false,
                "red_official_verify_type": 0,
                "show_red_official_verify_icon": false,
                "track_duration": 0,
                "userid": "671723b5000000001d030a49"
              },
              "widgets_context": "{\"flags\":{},\"author_id\":\"671723b5000000001d030a49\",\"author_name\":\"Ida Career\"}",
              "xsec_token": "YBH5CLeaPIJNlWaDfqwrlDrR8kEC56KxBV5LfA17zFx6c="
            }
          },

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
ai_mode
integer · optional
note_type
string · optional
page
integer · optional
search_id
string · optional
search_session_id
string · optional
sort_type
string · optional
source
string · optional
time_filter
string · optional

Access

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

API README

Xiaohongshu (RED) Note Search API

Search Xiaohongshu for a keyword and get matching notes with title, author, images and engagement counts. Sort by relevance, popularity or time and filter by note type.

Use cases

  • Research consumer opinions and trends on Xiaohongshu.
  • Find KOLs and popular notes for a product category.
  • Monitor brand mentions on RED.

Request

curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-notes" \
  -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"
ai_modeintegerNoAI mode, 0=off, 1=on
note_typestringNoNote type filter
search_idstringNoSearch ID, pass value from first search response for pagination
sort_typestringNoSort type
time_filterstringNoTime filter
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.

{
  "code": 0,
  "page": 1,
  "next_page": 2,
  "search_id": "<search_id>",
  "data": {
    "items": [
      {
        "model_type": "note",
        "note": {
          "id": "6a6c688000000000060041d4",
          "type": "normal",
          "liked_count": 98,
          "collected_count": 78,
          "comments_count": 56,
          "shared_count": 25,
          "timestamp": 1785489536,
          "title": "我发现我真的很会面OpenAI的MLE（已上岸",
          "user": {
            "nickname": "<user>"
          }
        }
      }
    ]
  }
}

Notes

  • For the next page, pass page, plus search_id and search_session_id from the first response.

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-notes
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-notes" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "source": "explore_feed",
  "ai_mode": 0,
  "keyword": "OpenAI",
  "note_type": "不限",
  "search_id": "",
  "sort_type": "general",
  "time_filter": "不限",
  "search_session_id": ""
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Xiaohongshu (RED) Note 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) Note Search API?

Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/app-v2/search-notes 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) Note 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) Note Search API accept?

Required: keyword (string). Optional: ai_mode (integer), note_type (string), page (integer), search_id (string), search_session_id (string) and sort_type (string) and 2 more. The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) Note 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) Note 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.