{
  "openapi": "3.0.0",
  "info": {
    "title": "小红书笔记搜索 API (V2)",
    "version": "1.0.0",
    "description": "获取小红书（RedNote）笔记搜索数据，包括摘要、作者和媒体，用于话题发现。"
  },
  "paths": {
    "/api/xiaohongshu/search-note/v2": {
      "get": {
        "tags": [
          "小红书"
        ],
        "summary": "笔记搜索",
        "description": "获取小红书（RedNote）笔记搜索数据，包括摘要、作者和媒体，用于话题发现。",
        "operationId": "getSearchNoteV2",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此 API 服务的访问令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "用于分页的页码。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "结果集的排序方式。\n\n可选值：\n- `general`：综合排序\n- `popularity_descending`：热度降序\n- `time_descending`：时间降序\n- `comment_descending`：评论数降序\n- `collect_descending`：收藏数降序",
            "required": false,
            "schema": {
              "type": "string",
              "default": "general",
              "description": "Xiaohongshu Search Note Sort",
              "enum": [
                "general",
                "popularity_descending",
                "time_descending",
                "comment_descending",
                "collect_descending"
              ]
            }
          },
          {
            "name": "noteType",
            "in": "query",
            "description": "笔记类型过滤器。\n\n可用值：\n- `_0`: 通用\n- `_1`: 视频\n- `_2`: 普通",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_0",
              "description": "Xiaohongshu Search Note Type",
              "enum": [
                "_0",
                "_1",
                "_2"
              ]
            }
          },
          {
            "name": "noteTime",
            "in": "query",
            "description": "按发布时间筛选。\n\n可用值：\n- `一天内`: Within one day\n- `一周内`: Within a week\n- `半年内`: Within half a year",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Xiaohongshu Search Note Note Time",
              "enum": [
                "一天内",
                "一周内",
                "半年内"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "items": [
                      {
                        "model_type": "note",
                        "note": {
                          "extract_text_enabled": 0,
                          "nice_count": 0,
                          "update_time": 1772963261000,
                          "xsec_token": "YBtw6gvZIq7-ULy_Lt2R72ZheGwXy_ackAgZ_tUQf29go=",
                          "interaction_area": {
                            "text": "15",
                            "type": 1,
                            "status": false
                          },
                          "result_from": "",
                          "type": "normal",
                          "last_update_time": 0,
                          "geo_info": {
                            "distance": ""
                          },
                          "niced": false,
                          "liked_count": 15,
                          "corner_tag_info": [
                            {
                              "location": -1,
                              "type": "ubt_sig_token",
                              "icon": "",
                              "text": "RAEKW4jTGbEtq0o0SM0BLG9Bqwn5t0uW/U5en9Ay3eOLTeRj09CE7PPMHORYNYaqNzAHnF908P1/UXS1oKWOz0EDuSfTJgash8",
                              "text_en": "",
                              "style": 0
                            }
                          ],
                          "collected": false,
                          "collected_count": 9,
                          "timestamp": 1772861202,
                          "user": {
                            "followed": false,
                            "red_official_verify_type": 0,
                            "track_duration": 0,
                            "show_red_official_verify_icon": false,
                            "red_official_verified": false,
                            "userid": "6276a4d10000000021026c1f",
                            "red_id": "1527435277",
                            "nickname": "郑州卖海信电视容声冰箱团购处",
                            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31gf10nru3s0g5ojmkj8ocr0v47fj5ro?imageView2/2/w/80/f..."
                          },
                          "has_music": false,
                          "desc": "#海信洗衣机 这是海信全家筒·棉花糖U7S，一款全球首创的6合1热泵洗护站，主打“衣鞋同净、分区健康洗护”。 核心亮点",
                          "tag_info": {
                            "title": "",
                            "type": ""
                          },
                          "cover_image_index": 0,
                          "advanced_widgets_groups": {
                            "groups": [
                              {
                                "mode": 1,
                                "fetch_types": [
                                  "guos_test"
                                ]
                              }
                            ]
                          },
                          "id": "69abb712000000001600a32a",
                          "images_list": [
                            {
                              "need_load_original_image": false,
                              "fileid": "notes_uhdr/1040g3qg31tdcat495m005ojmkj8ocr0v9fjbf2g",
                              "height": 5712,
                              "width": 4284,
                              "url": "https://sns-na-i8-a.xhscdn.com/notes_uhdr/1040g3qg31tdcat495m005ojmkj8ocr0v9fjbf2g?imageView2/2/w/60...",
                              "url_size_large": "https://sns-na-i8-a.xhscdn.com/notes_uhdr/1040g3qg31tdcat495m005ojmkj8ocr0v9fjbf2g?imageView2/2/w/14...",
                              "original": "",
                              "trace_id": "notes_uhdr/1040g3qg31tdcat495m005ojmkj8ocr0v9fjbf2g"
                            }
                          ],
                          "debug_info_str": "",
                          "widgets_context": "{\"flags\":{},\"author_id\":\"6276a4d10000000021026c1f\",\"author_name\":\"郑州卖海信电视容声冰箱团购处\"}",
                          "liked": false,
                          "shared_count": 14,
                          "comments_count": 25,
                          "note_attributes": []
                        }
                      }
                    ],
                    "query_type": 0,
                    "query_intent": {
                      "goodsIntent": 3,
                      "search_ask_intent": true,
                      "low_supply_intent": false
                    },
                    "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_required\",\"cost\":{\"all\":700,\"zone\":\"rcsh1\"}}",
                    "strategy_info": {
                      "query_can_guide_to_feed": true,
                      "query_average_impression_count": 19
                    },
                    "dqa_authorized_user_by_shared": false,
                    "show_single_col": false,
                    "search_request_id": "ff0597830871a638",
                    "ai_mode_enable": false,
                    "cur_cut_number": 0,
                    "query_debug_info": {
                      "is_forbidden": false
                    },
                    "is_broad_query": true,
                    "search_pull_down_opt_exp": 1,
                    "request_dqa_instant": true,
                    "search_dqa_new_page_exp": 1,
                    "dqa_instant_sid": "mGb86N4g1J",
                    "can_cut": false,
                    "request_dqa": 0
                  }
                }
              }
            }
          }
        },
        "x-order": "12002000"
      }
    }
  },
  "components": {}
}