当前浏览的是 v7 预览版文档(v7 尚未正式发布,API 可能随版本调整)。本页是 v7 新增内容,去 v6 正式版文档首页
@ikenxuan/amagi

笔记搜索结果列表

按关键词搜笔记。翻页手动传 `page`,并复用相同的 `search_id` / `session_id`;可指定排序和笔记类型。

GET
/api/xiaohongshu/fetch_search_notes

Authorization

bearerAuth
AuthorizationBearer <token>

仅在 startServer 传了 token 时生效

In: header

Query Parameters

keyword*string

搜索关键词

Length1 <= length
page?integer

页码,从 1 开始,默认 1

Range1 <= value <= 9007199254740991
page_size?integer

每页条数,默认 20

Range1 <= value <= 100
sort?string

排序,默认综合

Value in

  • "general"
  • "popularity_descending"
  • "time_descending"
note_type?number

笔记类型:0 全部,1 视频,2 图文

search_id?string

搜索标识;翻页时复用

Length1 <= length
session_id?string

搜索会话标识;翻页时复用

Length1 <= length

Response Body

application/json

application/json

curl -X GET "https://example.com/api/xiaohongshu/fetch_search_notes?keyword=string"
{  "success": true,  "data": {    "code": 0,    "data": {      "has_more": true,      "items": [        {          "hot_query": {            "queries": [              {                "cover": "string",                "id": "string",                "name": "string",                "search_word": "string"              }            ],            "source": 0,            "title": "string",            "word_request_id": "string"          },          "id": "string",          "model_type": "string",          "note_card": {            "corner_tag_info": [              {                "text": "string",                "type": "string"              }            ],            "cover": {              "height": 0,              "url_default": "string",              "url_pre": "string",              "width": 0            },            "display_title": "string",            "image_list": [              {                "height": 0,                "info_list": [                  {                    "image_scene": "string",                    "url": "string"                  }                ],                "width": 0              }            ],            "interact_info": {              "collected": true,              "collected_count": "string",              "comment_count": "string",              "liked": true,              "liked_count": "string",              "shared_count": "string"            },            "type": "string",            "user": {              "avatar": "string",              "nick_name": "string",              "nickname": "string",              "user_id": "string",              "xsec_token": "string"            }          },          "xsec_token": "string"        }      ]    },    "msg": "string",    "success": true  },  "error": {    "kind": "validation",    "code": "string",    "message": "string",    "retryable": true,    "platform": {      "code": "string",      "message": "string"    },    "http": {      "status": 0,      "statusText": "string"    },    "issues": [      {        "path": "string",        "message": "string",        "received": null      }    ]  },  "message": "string",  "meta": {    "requestId": "string",    "clientId": "string",    "platform": "douyin",    "endpoint": "string",    "durationMs": 0,    "attempts": 0,    "trace": [      {        "url": "string",        "method": "string",        "status": 0,        "durationMs": 0,        "reason": "initial",        "retryOf": "string"      }    ]  },  "requestPath": "/api/bilibili/fetch_one_video?bvid=BV1xx"}