raw.xiaohongshu.search

小红书笔记搜索

实时Beta

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

按关键词搜索小红书笔记，每页 20 条。data 是平台返回的搜索结果原始字段：items（每项含 model_type 和 note；note 里有 id、xsec_token、title、desc、type、liked_count、comments_count、collected_count、shared_count、timestamp、images_list、video_info_v2、user 等）及平台的其他字段，不做改名、筛选或换算；非笔记类的结果项（model_type 不是 note）也原样保留，只有笔记按条计费。可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型和发布时间筛选。用 page 翻页；响应不含 has_more，翻到没有结果（空结果，不计费）为止。

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

价格: $0.005 / 次$5 / 千次 · 固定价格
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:xiaohongshuAPI Key 需要这个 scope
限速: 不限流不按账户或接口限制每分钟请求数

请求参数

作为查询参数发送

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

keywordstring必填

搜索关键词

最多 50 字格式\S

示例咖啡

pageinteger

页码，从 1 开始；翻到没有结果时停止

默认1范围1–50

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 一周内、month 一个月内、year 一年内

默认all可选值all · 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"

把 $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": "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
  }
}

目录示例，不是实时数据

响应

成功返回 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: …` 开头。
`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

请求参数

响应

错误码

小红书的其他接口