Start building

Xiaohongshu (RED) Homepage Feed

Docs ↗
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.

Price
$0.01USD / call
Method
POST
Response
JSON
Parameters
0 required · 4 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

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.

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.

Pricing

Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
Xiaohongshu (RED) Homepage FeedThis API
Xiaohongshu		$0.01 per callJSON
Xiaohongshu (RED) Homepage Categories
Xiaohongshu		$0.01 per callJSON
Xiaohongshu (RED) Web Note Details
Xiaohongshu		$0.01 per callJSON
Xiaohongshu (RED) Search Suggestions
Xiaohongshu		$0.01 per callJSON
Xiaohongshu (RED) User Profile Information
Xiaohongshu		$0.01 per callJSON
Xiaohongshu (RED) Product Detail
Xiaohongshu		$0.01 per callJSON

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.