raw.xiaohongshu.search_v4

小红书笔记搜索 V4

实时Beta

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

按关键词搜索小红书笔记（原样 JSON 返回）：items（每条含笔记卡片：标题、作者、互动数、封面和图片）等。只返回第一页（约 20 条），没有翻页参数。可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型筛选，发布时间只支持不限、一天内、一周内。只对有数据的结果计费，空结果和出错都不计费。

常见用途：选题和热点追踪、关键词监测、跟进竞品动态。

价格: $0.02536 / 次$25.36 / 千次 · 固定价格
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:xiaohongshuAPI Key 需要这个 scope
限速: 仅账户限流账户每分钟上限

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

keywordstring必填

搜索关键词

最多 50 字格式\S

示例咖啡

sortstring · enum

排序：general 综合（默认）、latest 最新、most_liked 最多点赞、most_commented 最多评论、most_saved 最多收藏

默认general可选值general · latest · most_liked · most_commented · most_saved

note_typestring · enum

笔记类型：all 不限（默认）、video 视频笔记、image 图文笔记

默认all可选值all · video · image

note_timestring · enum

发布时间：all 不限（默认）、day 一天内、week 一周内

默认all可选值all · day · week

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

把 $QOVIA_KEY 换成你的 API Key

示例响应200 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": "0"
    },
    "is_broad_query": true,
    "items": [
      {
        "mix_track_id": "NOTE__6a428d8a00000000110176a2__2h36dws7ziokacdf33xuc__咖啡",
        "model_type": "note",
        "new_help_style": false,
        "note": {
          "abstract_show": "瑞幸其实能喝的并不多 筛选标准:…#瑞幸咖啡 #小黄油美式 #低卡饮品 #瑞幸 #咖啡 #减脂",
          "advanced_widgets_groups": {
            "groups": [
              {
                "fetch_types": [
                  "guos_test",
                  "note_next_step"
                ],
                "mode": 1
              },
              {
                "fetch_types": [
                  "guos_test",
                  "vote_stickers"
                ],
                "mode": 0
              }
            ]
          },
          "click_score": 0.0008327323012053967,
          "collected": false,
          "collected_count": 4668,
          "comments_count": 1127,
          "corner_tag_info": [
            {
              "icon": "",
              "location": -1,
              "style": 0,
              "text": "RAyNlYLhJk0ZwcVo/p7eH+3rmKeDSQ/UHW5mMEZZIJof11SsSzbvTAknoRHa13i2Gfy7bIsMmTOQ7/jUmVmNNuxLbEx1KRhHVj",
              "text_en": "",
              "type": "ubt_sig_token"
            },
            {
              "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png",
              "location": 5,
              "style": 0,
              "text": "06-30",
              "text_en": "06-30",
              "type": "publish_time"
            }
          ],
          "cover_image_index": 0,
          "debug_info_str": "",
          "desc": "筛选标准: 200大卡内，无植脂末，无果葡糖浆 植脂末和果葡糖浆很难代谢，当你摄入相同热量的饮品，但这些就是会让你长内脏",
          "extract_text_enabled": 0,
          "geo_info": {
            "distance": ""
          },
          "has_music": false,
          "id": "6a428d8a00000000110176a2",
          "images_list": [
            {
              "fileid": "1040g0083220lo77i746g5pardl325giko8059no",
              "height": 1600,
              "need_load_original_image": false,
              "original": "",
              "trace_id": "1040g0083220lo77i746g5pardl325giko8059no",
              "url": "https://sns-na-i2.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=829ad0b2f87a3746f8e424dfad17910f&t=6ae34abc",
              "url_size_large": "https://sns-na-i2.xhscdn.com/1040g0083220lo77i746g5pardl325giko8059no?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=829ad0b2f87a3746f8e424dfad17910f&t=6ae34abc",
              "width": 1200
            }
          ],
          "interaction_area": {
            "status": false,
            "text": "10807",
            "type": 1
          },
          "last_update_time": 1782748854,
          "liked": false,
          "liked_count": 10807,
          "nice_count": 0,
          "niced": false,
          "note_attributes": [],
          "result_from": "",
          "shared_count": 1427,
          "tag_info": {
            "title": "",
            "type": ""
          },
          "timestamp": 1782746506,
          "title": "瑞幸其实能喝的并不多",
          "type": "normal",
          "update_time": 1793257148000,
          "user": {
            "followed": false,
            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg",
            "nickname": "Sophia",
            "red_id": "1260070946",
            "red_official_verified": false,
            "red_official_verify_type": 0,
            "show_red_official_verify_icon": false,
            "track_duration": 0,
            "userid": "655b6d46000000000802c254"
          },
          "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}",
          "xsec_token": "YBxnVl_PvOuRQ9Umg3Q_boI2zfyOSLyilSPnHo16jmlaw="
        }
      },
      {
        "mix_track_id": "NOTE__69f7dc410000000035021f62__2h36dws7ziokacdf33xuc__咖啡",
        "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.0010656372178345919,
          "collected": false,
          "collected_count": 1002,
          "comments_count": 1652,
          "corner_tag_info": [
            {
              "icon": "",
              "location": -1,
              "style": 0,
              "text": "RAC3MDicwztm/hlEcs1ut8QMLUXUc/pcG3TYmtUhCcV8AAcwtDyQzHgjcN1KrMcFm6z22PkOHtpWHKlmvXO6dVww2G7mxzMop+",
              "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/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=1a17c22daabc3011b767e94a6bd4479e&t=6ae34abc",
              "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=1a17c22daabc3011b767e94a6bd4479e&t=6ae34abc",
              "width": 1920
            },
            {
              "fileid": "notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg",
              "height": 2560,
              "need_load_original_image": false,
              "original": "",
              "trace_id": "notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg",
              "url": "",
              "url_size_large": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmcg4a1oi1mr8elqrm2sgeg?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=9d0e5fd0ec565bea14911361dad0b6aa&t=6ae34abc",
              "width": 1920
            }
          ],
          "interaction_area": {
            "status": false,
            "text": "1256",
            "type": 1
          },
          "last_update_time": 1778137469,
          "liked": false,
          "liked_count": 1256,
          "nice_count": 0,
          "niced": false,
          "note_attributes": [],
          "result_from": "",
          "shared_count": 293,
          "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": "Joy",
            "red_id": "493145396",
            "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_name\":\"Joy\"}",
          "xsec_token": "YB84V9ZT2Ueq6cDx4qB3UUnRJv1qHZ9EWiMJ4uy_pMbvQ="
        }
      }
    ],
    "query_debug_info": {
      "is_forbidden": false
    },
    "query_intent": {
      "goodsIntent": 3,
      "low_supply_intent": false,
      "search_ask_intent": false
    },
    "query_type": 0,
    "request_dqa": 0,
    "request_dqa_instant": false,
    "search_dqa_new_page_exp": 0,
    "search_pull_down_opt_exp": 1,
    "search_request_id": "1c6c2cd660c6e4fd",
    "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_required\",\"cost\":{\"all\":758,\"zone\":\"rcsh1\"}}",
    "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.025360",
    "balance_usd": "9.974640",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、数组超过允许的条数、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用，请先充值。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录并充值；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key

请求参数

响应

错误码

小红书的其他接口