raw.xiaohongshu.search

Xiaohongshu (RedNote) note search

LiveBeta

GEThttps://api.qovia.ai/v1/raw/xiaohongshu/search

Search Xiaohongshu notes by keyword, 20 a page. data holds the platform's original search result: items (each with model_type and note; a note has id, xsec_token, title, desc, type, liked_count, comments_count, collected_count, shared_count, timestamp, images_list, video_info_v2, user and so on) and the platform's other fields, unrenamed, unfiltered and unconverted; result items that are not notes (model_type other than note) are kept as they come, and only notes are charged. Sort by relevance, newest, most liked, most commented or most saved; filter by note type and publish time. Page with page; the response has no has_more, so go on until a page comes back empty (not charged).

Typical uses: Tracking trends and topics, monitoring keywords and following competitors.

Price: $0.005 / call$5 per 1k · fixed price
Billing: Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope: raw:xiaohongshuThe API key needs this scope
Rate limit: NoneNo per-account or per-endpoint request limit

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

keywordstringRequired

Search keyword

Max 50 charsPattern\S

Example咖啡

pageinteger

Page number, from 1; stop when a page comes back empty

Default1Range1–50

sortstring · enum

Order: general (relevance, the default), latest, most_liked, most_commented or most_saved

DefaultgeneralOne ofgeneral · latest · most_liked · most_commented · most_saved

note_typestring · enum

Note type: all (the default), video or image notes

DefaultallOne ofall · video · image

note_timestring · enum

Published within: all (the default), a day, a week, a month or a year

DefaultallOne ofall · day · week · month · year

curl 'https://api.qovia.ai/v1/raw/xiaohongshu/search?keyword=%E5%92%96%E5%95%A1' \
  -H "Authorization: Bearer $QOVIA_KEY"

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "ai_mode_enable": false,
    "can_cut": false,
    "cur_cut_number": 0,
    "dqa_authorized_user_by_shared": false,
    "extra_info": {
      "atmosphere_v3_enable": "1"
    },
    "is_broad_query": true,
    "items": [
      {
        "mix_track_id": "NOTE__69f7dc410000000035021f62__2h1xudxi36i2kzu0g9340__咖啡",
        "model_type": "note",
        "new_help_style": false,
        "note": {
          "advanced_widgets_groups": {
            "groups": [
              {
                "fetch_types": [
                  "guos_test",
                  "note_next_step"
                ],
                "mode": 1
              },
              {
                "fetch_types": [
                  "guos_test",
                  "vote_stickers"
                ],
                "mode": 0
              }
            ]
          },
          "click_score": 0.03819393366575241,
          "collected": false,
          "collected_count": 966,
          "comments_count": 1570,
          "corner_tag_info": [
            {
              "icon": "",
              "location": -1,
              "style": 0,
              "text": "RANdXp0+VM73eUyvLVw+K4LXoF6C8zUygl9n+arZ59HzL3TswBWWAWOqL9sf…",
              "text_en": "",
              "type": "ubt_sig_token"
            },
            {
              "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png",
              "location": 5,
              "style": 0,
              "text": "05-07",
              "text_en": "05-07",
              "type": "publish_time"
            }
          ],
          "cover_image_index": 0,
          "debug_info_str": "",
          "desc": "图一开封的地方，真的字体会比较清爽，假的是比较粗的，下面的8，真的是相对会扁一点，两个在一起对比有很明显的不同 图二很明",
          "extract_text_enabled": 0,
          "geo_info": {
            "distance": ""
          },
          "has_music": false,
          "id": "69f7dc410000000035021f62",
          "images_list": [
            {
              "fileid": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo",
              "height": 2560,
              "need_load_original_image": false,
              "original": "",
              "trace_id": "notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo",
              "url": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=5&sc=SRH_PRV&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c",
              "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c",
              "width": 1920
            }
          ],
          "interaction_area": {
            "status": false,
            "text": "1205",
            "type": 1
          },
          "last_update_time": 1778137469,
          "liked": false,
          "liked_count": 1205,
          "nice_count": 0,
          "niced": false,
          "note_attributes": [],
          "result_from": "",
          "shared_count": 287,
          "tag_info": {
            "title": "",
            "type": ""
          },
          "timestamp": 1777851457,
          "title": "真假摩可纳咖啡对比（一）",
          "type": "normal",
          "update_time": 1778137512000,
          "user": {
            "followed": false,
            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31khvup72iu6g4a1oi1mr8elqqcbfmbo?imageView2/2/w/80/format/jpg",
            "nickname": "J***y",
            "red_id": "493***96",
            "red_official_verified": false,
            "red_official_verify_type": 0,
            "show_red_official_verify_icon": false,
            "track_duration": 0,
            "userid": "5a916db4e8ac2b54e8b53aba"
          },
          "widgets_context": "{\"flags\":{},\"author_id\":\"5a916db4e8ac2b54e8b53aba\",\"author_n…",
          "xsec_token": "YB-Ez6A0sUGde5rEnUs_DNj_OvWS4G9u7E3deUxhBsV3w="
        }
      },
      {
        "mix_track_id": "NOTE__699ac514000000001a023963__2h1xudxi36i2kzu0g9340__咖啡",
        "model_type": "note",
        "new_help_style": false,
        "note": {
          "advanced_widgets_groups": {
            "groups": [
              {
                "fetch_types": [
                  "guos_test",
                  "note_next_step"
                ],
                "mode": 1
              },
              {
                "fetch_types": [
                  "guos_test",
                  "vote_stickers"
                ],
                "mode": 0
              }
            ]
          },
          "click_score": 0.004283426329493523,
          "collected": false,
          "collected_count": 43,
          "comments_count": 148,
          "corner_tag_info": [
            {
              "icon": "",
              "location": -1,
              "style": 0,
              "text": "RAXvgVeqGkBM4UA2L7CFkMSkgBg9t+BCeOmgJb32iGUC8L6wDeKMT3MxNPil…",
              "text_en": "",
              "type": "ubt_sig_token"
            },
            {
              "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png",
              "location": 5,
              "style": 0,
              "text": "02-22",
              "text_en": "02-22",
              "type": "publish_time"
            }
          ],
          "cover_image_index": 0,
          "debug_info_str": "",
          "desc": "回来过年想约老友来坐坐。结果老友们全都忙，店也倒闭了。好难过。人到中年突然失去了和旧时朋友相聚的机会。#南阳市",
          "extract_text_enabled": 0,
          "geo_info": {
            "distance": ""
          },
          "has_music": false,
          "id": "699ac514000000001a023963",
          "images_list": [
            {
              "fileid": "1040g00831ssql5qnm85g5p7o7621m63o0hcapb0",
              "height": 3072,
              "need_load_original_image": false,
              "original": "",
              "trace_id": "1040g00831ssql5qnm85g5p7o7621m63o0hcapb0",
              "url": "https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0/enhance/4&ap=5&sc=SRH_PRV&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c",
              "url_size_large": "https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c",
              "width": 4096
            }
          ],
          "interaction_area": {
            "status": false,
            "text": "245",
            "type": 1
          },
          "last_update_time": 0,
          "liked": false,
          "liked_count": 245,
          "nice_count": 0,
          "niced": false,
          "note_attributes": [],
          "result_from": "",
          "shared_count": 132,
          "tag_info": {
            "title": "",
            "type": ""
          },
          "timestamp": 1771750676,
          "title": "天塌了，陪伴了南阳二十年的哥德咖啡倒闭了",
          "type": "normal",
          "update_time": 1773364428000,
          "user": {
            "followed": false,
            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo318qfc8vbk66g5p7o7621m63ouvi1mq8?imageView2/2/w/80/format/jpg",
            "nickname": "霜*",
            "red_id": "999***86",
            "red_official_verified": false,
            "red_official_verify_type": 0,
            "show_red_official_verify_icon": false,
            "track_duration": 0,
            "userid": "64f839840000000006031878"
          },
          "widgets_context": "{\"flags\":{},\"author_id\":\"64f839840000000006031878\",\"author_name\":\"霜恸\"}",
          "xsec_token": "YBn1AYa_Qg976rX5bKUocOBOVnyGc_b-VozRlTvKiGUo8="
        }
      }
    ],
    "query_debug_info": {
      "is_forbidden": false
    },
    "query_intent": {
      "goodsIntent": 3,
      "low_supply_intent": false,
      "search_ask_intent": true
    },
    "query_type": 0,
    "request_dqa": 0,
    "request_dqa_instant": false,
    "search_dqa_new_page_exp": 1,
    "search_pull_down_opt_exp": 1,
    "search_request_id": "1818628fea100600",
    "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_requ…",
    "show_single_col": false,
    "strategy_info": {
      "query_average_impression_count": 19,
      "query_can_guide_to_feed": true
    },
    "taxonomy1": "5ab094be481d26b8ef9045f1",
    "video_intent_grade_v3": 1
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.005000",
    "balance_usd": "9.995000",
    "empty": false
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
`invalid_params`	400	Not charged	The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call; top up first.
`upstream_busy`Retryable	503	Refunded	The data source is busy or cooling down; refunded. Retry after `Retry-After`.
`upstream_timeout`	504	Refunded	The data source timed out; refunded.
`upstream_error`	502 / 503	Refunded	The data source failed; refunded.
`upstream_rejected`	400	Refunded	The data source rejected these parameters (well-formed, but not accepted); refunded.
`not_found`	404	Refunded	The data source has no such item (deleted, or the ID does not exist); refunded.
`reservation_expired`	504	Refunded	The call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code

Call it from your browser

Needs an account with a balance; playground calls are billed like API calls.

Try in the playground Create an API key

Parameters

Response

Errors

More Xiaohongshu (RedNote) endpoints