Start building

Xiaohongshu (RED) Homepage Feed

https://api.sandbase.ai/v1/api/xiaohongshu/web-v3/homefeed

Retrieves recommended notes from the Xiaohongshu homepage feed. Supports filtering by category channel, restricting results to image notes, and paginating via cursor score.

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

Try the model

Playground

Open playground
Input
Category channel ID
Pagination cursor
Image notes only
Number of results, max 40 Maximum: 40.
OutputExample
Responseoutputs · 37.6 KB · 811 lines
[
  {
    "data": {
      "code": 0,
      "data": {
        "cursor_score": "1.7860909709800014E9",
        "items": [
          {
            "id": "6a583e5a000000000100d5c2",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 2560,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/f302fd389f65422b2d887becb743658d/note_pre_post_uhdr/1040g3r0322lroomgnk0049q2qcslp3ss936t820!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/339b8a60c24dac2415db193a8be736fe/note_pre_post_uhdr/1040g3r0322lroomgnk0049q2qcslp3ss936t820!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/339b8a60c24dac2415db193a8be736fe/note_pre_post_uhdr/1040g3r0322lroomgnk0049q2qcslp3ss936t820!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/f302fd389f65422b2d887becb743658d/note_pre_post_uhdr/1040g3r0322lroomgnk0049q2qcslp3ss936t820!nc_n_webp_prv_1?src=A",
                "width": 1920
              },
              "display_title": "避雷肯德基，品控咋越来越差",
              "interact_info": {
                "liked": false,
                "liked_count": "2172"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo31jktdrnlio0049q2qcslp3ssldsugcg",
                "nick_name": "WY",
                "nickname": "WY",
                "user_id": "59bdf95c51783a05d3c78f9c",
                "xsec_token": "ABID-WX7Flbuupq1AS9m4SGnSxDJY4EYp1yKWDeazkxmg="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "ABCPGMn7J3_0h0pJSktU7sqn2KIHL1kKs4rMU-dbkc_vg="
          },
          {
            "id": "6a4b219800000000160253c8",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 1744,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/3cc501b75515e4204672b95c587753a7/notes_pre_post/1040g3k8322922t8vnk004a1nci4blvihiqp1r10!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/b95f88b99db85d8d392538fb8dce25ff/notes_pre_post/1040g3k8322922t8vnk004a1nci4blvihiqp1r10!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/b95f88b99db85d8d392538fb8dce25ff/notes_pre_post/1040g3k8322922t8vnk004a1nci4blvihiqp1r10!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/3cc501b75515e4204672b95c587753a7/notes_pre_post/1040g3k8322922t8vnk004a1nci4blvihiqp1r10!nc_n_webp_prv_1?src=A",
                "width": 1308
              },
              "display_title": "1800请的阿姨今天35℃给我做的饭",
              "interact_info": {
                "liked": false,
                "liked_count": "1717"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo31cktvjccgu004a1nci4blviho4k9590",
                "nick_name": "哆尔",
                "nickname": "哆尔",
                "user_id": "5a9048ba11be104c9cb2fe51",
                "xsec_token": "ABs2EJ74MnYmIbpd2T3ORn0no4DSYJIMw9AswvSnMRrTc="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "ABQr8kTK3gyMpxjbWNmF1izTbkjcHkhKkl4q6xmqiE6z8="
          },
          {
            "id": "6a56d2800000000011018150",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 1600,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/b29ceb129cc4f37acc87d0f98e808c74/1040g2sg322kf3ah172f05nt8tqgg8409t64uu7g!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/a4e6d60104742ab855daee996332cfc4/1040g2sg322kf3ah172f05nt8tqgg8409t64uu7g!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/a4e6d60104742ab855daee996332cfc4/1040g2sg322kf3ah172f05nt8tqgg8409t64uu7g!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/b29ceb129cc4f37acc87d0f98e808c74/1040g2sg322kf3ah172f05nt8tqgg8409t64uu7g!nc_n_webp_prv_1?src=A",
                "width": 1200
              },
              "display_title": "姨妈第三天排出来惊天大血块",
              "interact_info": {
                "liked": false,
                "liked_count": "490"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo321jfcv30ms0g5nt8tqgg84092rne2cg",
                "nick_name": "胖圆调理记",
                "nickname": "胖圆调理记",
                "user_id": "5fa8eea10000000001001009",
                "xsec_token": "AB0muILKa8QbNcXgWXARB43xB6zlSA6v4CYuYDruS-qQc="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "ABHPMhErDdQ-NH2QO_H98ftDoJIfX4OwACA1bBEYWN9vE="
          },
          {
            "id": "6a4dab0a000000001503e928",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 4032,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/4d452dc03ce4fc05a6c75325d27cfdd1/note_pre_post_uhdr/1040g3r0322bh9q1e7o005nrtfiqg89dlnb9affo!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/f4adeadaa2049c0cf2baf328343afc63/note_pre_post_uhdr/1040g3r0322bh9q1e7o005nrtfiqg89dlnb9affo!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/f4adeadaa2049c0cf2baf328343afc63/note_pre_post_uhdr/1040g3r0322bh9q1e7o005nrtfiqg89dlnb9affo!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/4d452dc03ce4fc05a6c75325d27cfdd1/note_pre_post_uhdr/1040g3r0322bh9q1e7o005nrtfiqg89dlnb9affo!nc_n_webp_prv_1?src=A",
                "width": 3024
              },
              "display_title": "还有比我更傻的纹身吗",
              "interact_info": {
                "liked": false,
                "liked_count": "4669"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/6479b0c962f617296a6a4eb8.jpg",
                "nick_name": "哈喽珍妮",
                "nickname": "哈喽珍妮",
                "user_id": "5f7d7cb500000000010025b5",
                "xsec_token": "ABaQ-l-jgIPkV02bXYYonvCFU6MPbOLEy4rtxSgtkts2I="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "AB8EOoCEdhV9RCGbx8dIToSUQwWjeR2ultB9XRkUOGLSA="
          },
          {
            "id": "6a4c86a8000000001702f044",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 1600,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/7139d46190ae67d8fe1edbbe008ab477/notes_pre_post/1040g3k8322ad0a507ae05o9pmho7vfut9k2hc7o!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/5bd2be486aeeb743d55a1b8c31db29e9/notes_pre_post/1040g3k8322ad0a507ae05o9pmho7vfut9k2hc7o!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/5bd2be486aeeb743d55a1b8c31db29e9/notes_pre_post/1040g3k8322ad0a507ae05o9pmho7vfut9k2hc7o!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/7139d46190ae67d8fe1edbbe008ab477/notes_pre_post/1040g3k8322ad0a507ae05o9pmho7vfut9k2hc7o!nc_n_webp_prv_1?src=A",
                "width": 1200
              },
              "display_title": "有没有好看的纯色美甲啊啊啊啊啊",
              "interact_info": {
                "liked": false,
                "liked_count": "2028"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo322afrfus7ae05o9pmho7vfut4a5ks3o",
                "nick_name": "羊癲癫",
                "nickname": "羊癲癫",
                "user_id": "6139b470000000001f03bfdd",
                "xsec_token": "AByJK-257g3tEn76pNYBX55IOV2am6vOBLaxzW1voD1ik="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "AB83epUdDjAvXhJaIk5pC03RdPrfDA_Zv1eGiioFcgaVw="
          },
          {
            "id": "6a503c64000000000f016f86",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 1440,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/b35adf9c36cdf97919d0756fbbe6f971/1040g2sg322e1i35o732g5qia7fp40400gr56fn8!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/ce71c67099609cdbee7589ab83bd0055/1040g2sg322e1i35o732g5qia7fp40400gr56fn8!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/ce71c67099609cdbee7589ab83bd0055/1040g2sg322e1i35o732g5qia7fp40400gr56fn8!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/b35adf9c36cdf97919d0756fbbe6f971/1040g2sg322e1i35o732g5qia7fp40400gr56fn8!nc_n_webp_prv_1?src=A",
                "width": 1080
              },
              "display_title": "论练背的重要性 ",
              "interact_info": {
                "liked": false,
                "liked_count": "755"
              },
              "type": "video",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo3228cis9o6u6g5qia7fp40400shl2isg",
                "nick_name": "臀会跳舞的girl",
                "nickname": "臀会跳舞的girl",
                "user_id": "6a4a3bf20000000010001000",
                "xsec_token": "ABkhhiHHkGjI6ep2ae-NXP8aZ-OStIg-Wfnp668-l8ULA="
              },
              "video": {
                "capa": {
                  "duration": 29
                }
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "ABxJoiUsQuyPUIeGPVoVnHtLxh6LS9OWNTkZ7B8hzOSYo="
          },
          {
            "id": "6a55befe000000000f031f0f",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 1600,
                "info_list": [
                  {
                    "image_scene": "WB_PRV",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/596b775a30fabb1c60942beda282e849/notes_pre_post/1040g3k0322jdjvihne2g5ndk10d08rdoal7t1eo!nc_n_webp_prv_1?src=A"
                  },
                  {
                    "image_scene": "WB_DFT",
                    "url": "http://sns-web-i10.rednotecdn.com/202608071622/139134898bf8f001f3640e85cde4e6c9/notes_pre_post/1040g3k0322jdjvihne2g5ndk10d08rdoal7t1eo!nc_n_webp_mw_1?src=A"
                  }
                ],
                "url": "",
                "url_default": "http://sns-web-i10.rednotecdn.com/202608071622/139134898bf8f001f3640e85cde4e6c9/notes_pre_post/1040g3k0322jdjvihne2g5ndk10d08rdoal7t1eo!nc_n_webp_mw_1?src=A",
                "url_pre": "http://sns-web-i10.rednotecdn.com/202608071622/596b775a30fabb1c60942beda282e849/notes_pre_post/1040g3k0322jdjvihne2g5ndk10d08rdoal7t1eo!nc_n_webp_prv_1?src=A",
                "width": 1200
              },
              "display_title": "养猫最必要的开支是什么？",
              "interact_info": {
                "liked": false,
                "liked_count": "266"
              },
              "type": "normal",
              "user": {
                "avatar": "https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo320i7voulli005ne1hilg83lihebkg08",
                "nick_name": "小幸福",
                "nickname": "小幸福",
                "user_id": "5dc18cab0000000001000eb2",
                "xsec_token": "ABXWDvljw8ITpN8mpbbfrr260dDXY1152eu9f2JTsDCGM="
              }
            },
            "track_id": "2gqbhexns9qta5r33xywx",
            "xsec_token": "ABN95XScpButCHande-8jHSXqOC5ae1Ah_jO8nhdrXxYE="
          },
          {
            "id": "6a5288eb000000001702c033",
            "ignore": false,
            "model_type": "note",
            "note_card": {
              "cover": {
                "file_id": "",
                "height": 3839,

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

category
string · optional
cursor_score
string · optional
need_filter_image
boolean · optional
num
integer · optional

Access

Provider
Xiaohongshu
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/xiaohongshu/web-v3/homefeed
Authentication
Bearer API key

API README

Xiaohongshu (RED) Homepage Feed API

Access recommended homepage feed notes using optional parameters such as category, num, cursor_score, and need_filter_image.

Use cases

  • Retrieve recommended note feeds for discovery analysis.
  • Filter homepage recommendations to image-only note posts.
  • Monitor trending content across specific category channels.

Request

curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/web-v3/homefeed" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

NameTypeRequiredDescription
numintegerNoNumber of results, max 40
categorystringNoCategory channel ID
cursor_scorestringNoPagination cursor
need_filter_imagebooleanNoImage notes only

Notes

  • num specifies the count of returned results up to a maximum of 40.
  • Use cursor_score to paginate through subsequent pages of the 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/web-v3/homefeed
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/web-v3/homefeed" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "num": 20,
  "category": "homefeed_recommend",
  "cursor_score": "",
  "need_filter_image": false
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Xiaohongshu (RED) Homepage FeedThis API
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Homepage Categories
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Web Note Details
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) Search Suggestions
Xiaohongshu		$0.01 per callJSONJul 31, 2026
Xiaohongshu (RED) User Profile Information
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) Homepage Feed API?

Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/web-v3/homefeed 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) Homepage Feed 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) Homepage Feed API accept?

No parameters are required. Optional: category (string), cursor_score (string), need_filter_image (boolean) and num (integer). The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) Homepage Feed API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Xiaohongshu developer account or API key?

No. Xiaohongshu (RED) Homepage Feed 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.