---
title: "Xiaohongshu (RedNote) Keyword Note Search API (V2)"
description: "Searches Xiaohongshu (RedNote) notes by keyword with page-based pagination, sorting and note-type filters. The V2 noteTime filter may return notes outside the selected time range. This endpoint does not search user accounts."
aiUsagePrompt: true
---

# Xiaohongshu \(RedNote\) Keyword Note Search API \(V2\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/xiaohongshu/search-note/v2\"")'
  :summary='JSON.parse("\"Keyword Note Search (V2)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/xiaohongshu-rednote/note-search-v2-en.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"Access token for this API service.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"keyword\",\"in\":\"query\",\"description\":\"Search keyword.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"page\",\"in\":\"query\",\"description\":\"Page number for pagination. Start at 1, then increment page while keeping the keyword and filters unchanged.\",\"required\":false,\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"name\":\"sort\",\"in\":\"query\",\"description\":\"Sort order for the result set.\\n\\nAvailable Values:\\n- `general`: General\\n- `popularity_descending`: Popularity Descending\\n- `time_descending`: Time Descending\\n- `comment_descending`: Comment Descending\\n- `collect_descending`: 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\":\"Note type filter.\\n\\nAvailable Values:\\n- `_0`: General\\n- `_1`: Video\\n- `_2`: Normal\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"_0\",\"description\":\"Xiaohongshu search note type\",\"enum\":[\"_0\",\"_1\",\"_2\"]}},{\"name\":\"noteTime\",\"in\":\"query\",\"description\":\"Note publish time filter. Results may include notes published outside the selected time range.\\n\\nAvailable Values:\\n- `ONE_DAY`: Within one day\\n- `ONE_WEEK`: Within a week\\n- `HALF_YEAR`: Within half a year\",\"required\":false,\"schema\":{\"type\":\"string\",\"description\":\"Xiaohongshu search note publish time filter\",\"enum\":[\"ONE_DAY\",\"ONE_WEEK\",\"HALF_YEAR\"]}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"OK\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"description\":\"Fields returned when a Xiaohongshu keyword note search response contains a result page.\",\"properties\":{\"items\":{\"type\":\"array\",\"description\":\"The results on the requested search page. Successful responses can contain an empty list, and notes can repeat across pages.\",\"items\":{\"type\":\"object\",\"description\":\"A search result card.\",\"properties\":{\"model_type\":{\"type\":\"string\",\"description\":\"The card model type reported by Xiaohongshu. Observed cards include note and ads.\"},\"note\":{\"type\":\"object\",\"description\":\"The note associated with an ordinary note card, when present.\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The Xiaohongshu note ID.\"},\"type\":{\"type\":\"string\",\"description\":\"The note type reported by Xiaohongshu. Observed values include normal for image notes and video for video notes.\"},\"title\":{\"type\":\"string\",\"description\":\"The note title, when returned.\"},\"desc\":{\"type\":\"string\",\"description\":\"The note text or description returned with the search card.\"},\"timestamp\":{\"type\":\"integer\",\"description\":\"The note timestamp returned with the result, as a Unix timestamp in seconds.\"},\"update_time\":{\"type\":\"integer\",\"description\":\"The update timestamp supplied for the search result, as a Unix timestamp in milliseconds.\"},\"last_update_time\":{\"type\":\"integer\",\"description\":\"The last update time reported for the note, as a Unix timestamp in seconds. It can be zero.\"},\"liked_count\":{\"type\":\"integer\",\"description\":\"The like count reported for the search card.\"},\"nice_count\":{\"type\":\"integer\",\"description\":\"The separate nice count reported by Xiaohongshu for the note.\"},\"comments_count\":{\"type\":\"integer\",\"description\":\"The number of comments reported for the note.\"},\"collected_count\":{\"type\":\"integer\",\"description\":\"The number of saves reported for the note.\"},\"shared_count\":{\"type\":\"integer\",\"description\":\"The number of shares reported for the note.\"},\"liked\":{\"type\":\"boolean\",\"description\":\"The like status reported by Xiaohongshu for the current response context.\"},\"niced\":{\"type\":\"boolean\",\"description\":\"The separate nice status reported by Xiaohongshu for the current response context.\"},\"collected\":{\"type\":\"boolean\",\"description\":\"The save status reported by Xiaohongshu for the current response context.\"},\"has_music\":{\"type\":\"boolean\",\"description\":\"Whether the response indicates music is associated with the note.\"},\"video_duration\":{\"type\":\"string\",\"description\":\"The video duration returned as display text, such as 1:05.\"},\"cover_image_index\":{\"type\":\"integer\",\"description\":\"The index reported for the cover image in images_list.\"},\"note_attributes\":{\"type\":\"array\",\"description\":\"Note attributes reported by Xiaohongshu.\",\"items\":{\"type\":\"string\",\"description\":\"A note attribute value as returned by Xiaohongshu.\"}},\"xsec_token\":{\"type\":\"string\",\"description\":\"The Xiaohongshu token associated with the note link, when returned.\"},\"user\":{\"type\":\"object\",\"description\":\"Author information returned for the note.\",\"properties\":{\"userid\":{\"type\":\"string\",\"description\":\"The Xiaohongshu user ID of the note author.\"},\"red_id\":{\"type\":\"string\",\"description\":\"The author&#39;s displayed Xiaohongshu account ID.\"},\"nickname\":{\"type\":\"string\",\"description\":\"The author&#39;s display name.\"},\"images\":{\"type\":\"string\",\"description\":\"The author&#39;s profile avatar URL.\"},\"followed\":{\"type\":\"boolean\",\"description\":\"The follow flag returned for the author in the current response context.\"},\"red_official_verified\":{\"type\":\"boolean\",\"description\":\"The official verification flag returned for the author.\"},\"red_official_verify_type\":{\"type\":\"integer\",\"description\":\"The official verification type code reported for the author.\"},\"show_red_official_verify_icon\":{\"type\":\"boolean\",\"description\":\"Whether the platform indicates that the official verification icon should be displayed.\"}}},\"at_user_list\":{\"type\":\"array\",\"description\":\"Accounts mentioned in the note, when returned.\",\"items\":{\"type\":\"object\",\"description\":\"An account mentioned in the note.\",\"properties\":{\"user_id\":{\"type\":\"string\",\"description\":\"The Xiaohongshu user ID of the mentioned account.\"},\"nickname\":{\"type\":\"string\",\"description\":\"The display name returned for the mentioned account.\"}}}},\"images_list\":{\"type\":\"array\",\"description\":\"Images associated with the note, which can include cover images for video notes.\",\"items\":{\"type\":\"object\",\"description\":\"An image associated with the note.\",\"properties\":{\"fileid\":{\"type\":\"string\",\"description\":\"The platform file ID of the image.\"},\"width\":{\"type\":\"integer\",\"description\":\"The width value returned for the image.\"},\"height\":{\"type\":\"integer\",\"description\":\"The height value returned for the image.\"},\"url\":{\"type\":\"string\",\"description\":\"The image URL returned for display.\"},\"original\":{\"type\":\"string\",\"description\":\"The original image URL, when returned.\"},\"url_size_large\":{\"type\":\"string\",\"description\":\"The large image URL, when returned.\"},\"live_photo_file_id\":{\"type\":\"string\",\"description\":\"The platform file ID of the Live Photo, when returned.\"},\"live_photo\":{\"type\":\"object\",\"description\":\"Live Photo metadata returned for the image when available.\",\"properties\":{\"media\":{\"type\":\"object\",\"description\":\"Playback metadata supplied for the Live Photo.\",\"properties\":{\"video_id\":{\"type\":\"integer\",\"description\":\"The numeric platform video ID returned for the Live Photo.\"},\"video\":{\"type\":\"object\",\"description\":\"Video metadata associated with the Live Photo.\",\"properties\":{\"width\":{\"type\":\"integer\",\"description\":\"Video width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Video height in pixels.\"},\"duration\":{\"type\":\"integer\",\"description\":\"Video duration reported in whole seconds.\"},\"drm_type\":{\"type\":\"integer\",\"description\":\"Raw DRM category code reported for the video.\"},\"hdr_type\":{\"type\":\"integer\",\"description\":\"Raw HDR category code reported for the video.\"},\"stream_types\":{\"type\":\"array\",\"description\":\"Stream type codes reported for the video.\",\"items\":{\"type\":\"integer\",\"description\":\"Raw stream type code reported for the video.\"}}}},\"stream\":{\"type\":\"object\",\"description\":\"Stream variants grouped by the codec labels returned by Xiaohongshu.\",\"properties\":{\"h264\":{\"type\":\"array\",\"description\":\"H.264 streams returned for the Live Photo.\",\"items\":{\"type\":\"object\",\"description\":\"Metadata for one H.264 Live Photo stream.\",\"properties\":{\"master_url\":{\"type\":\"string\",\"description\":\"Primary URL supplied for this stream.\"},\"backup_urls\":{\"type\":\"array\",\"description\":\"Alternate URLs supplied for the stream.\",\"items\":{\"type\":\"string\",\"description\":\"Alternate stream URL.\"}},\"width\":{\"type\":\"integer\",\"description\":\"Stream width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Stream height in pixels.\"},\"fps\":{\"type\":\"integer\",\"description\":\"Frame rate reported for the stream.\"},\"format\":{\"type\":\"string\",\"description\":\"Media format reported for the stream.\"},\"video_codec\":{\"type\":\"string\",\"description\":\"Video codec reported for the stream.\"},\"audio_codec\":{\"type\":\"string\",\"description\":\"Audio codec reported for the stream. It may be empty.\"},\"audio_channels\":{\"type\":\"integer\",\"description\":\"Number of audio channels reported for the stream.\"},\"avg_bitrate\":{\"type\":\"integer\",\"description\":\"Average bitrate value reported for the stream.\"},\"video_bitrate\":{\"type\":\"integer\",\"description\":\"Video bitrate value reported for the stream.\"},\"audio_bitrate\":{\"type\":\"integer\",\"description\":\"Audio bitrate value reported for the stream.\"},\"quality_type\":{\"type\":\"string\",\"description\":\"Raw quality label reported for the stream.\"},\"stream_desc\":{\"type\":\"string\",\"description\":\"Description supplied by Xiaohongshu for the stream.\"},\"duration\":{\"type\":\"integer\",\"description\":\"Stream duration value reported by Xiaohongshu.\"},\"video_duration\":{\"type\":\"integer\",\"description\":\"Video duration value reported for the stream.\"},\"audio_duration\":{\"type\":\"integer\",\"description\":\"Audio duration value reported for the stream.\"},\"size\":{\"type\":\"integer\",\"description\":\"Stream size value reported by Xiaohongshu.\"}}}},\"h265\":{\"type\":\"array\",\"description\":\"H.265 streams returned for the Live Photo.\"},\"h266\":{\"type\":\"array\",\"description\":\"H.266 stream list returned by Xiaohongshu. It may be empty.\"},\"av1\":{\"type\":\"array\",\"description\":\"AV1 stream list returned by Xiaohongshu. It may be empty.\"}}}}}}}}}},\"video_info_v2\":{\"type\":\"object\",\"description\":\"Video metadata and media streams returned for the note, when available.\",\"properties\":{\"image\":{\"type\":\"object\",\"description\":\"Preview images returned for the video.\",\"properties\":{\"first_frame\":{\"type\":\"string\",\"description\":\"The URL returned for the first-frame image.\"},\"thumbnail\":{\"type\":\"string\",\"description\":\"The thumbnail image URL, when returned.\"},\"thumbnail_dim\":{\"type\":\"string\",\"description\":\"Additional thumbnail URL supplied for the video.\"}}},\"media\":{\"type\":\"object\",\"description\":\"Video and playback stream metadata for the note.\",\"properties\":{\"video\":{\"type\":\"object\",\"description\":\"Video metadata associated with the video note.\",\"properties\":{\"width\":{\"type\":\"integer\",\"description\":\"Video width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Video height in pixels.\"},\"duration\":{\"type\":\"integer\",\"description\":\"Video duration reported in whole seconds.\"},\"drm_type\":{\"type\":\"integer\",\"description\":\"Raw DRM category code reported for the video.\"},\"hdr_type\":{\"type\":\"integer\",\"description\":\"Raw HDR category code reported for the video.\"},\"stream_types\":{\"type\":\"array\",\"description\":\"Stream type codes reported for the video.\",\"items\":{\"type\":\"integer\",\"description\":\"Raw stream type code reported for the video.\"}},\"md5\":{\"type\":\"string\",\"description\":\"MD5 value reported in the video metadata.\"}}},\"stream\":{\"type\":\"object\",\"description\":\"Stream variants grouped by the codec labels returned by Xiaohongshu.\",\"properties\":{\"h264\":{\"type\":\"array\",\"description\":\"H.264 streams returned for the video note.\",\"items\":{\"type\":\"object\",\"description\":\"Metadata for one H.264 video stream.\",\"properties\":{\"master_url\":{\"type\":\"string\",\"description\":\"Primary URL supplied for this stream.\"},\"backup_urls\":{\"type\":\"array\",\"description\":\"Alternate URLs supplied for the stream.\",\"items\":{\"type\":\"string\",\"description\":\"Alternate stream URL.\"}},\"width\":{\"type\":\"integer\",\"description\":\"Stream width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Stream height in pixels.\"},\"fps\":{\"type\":\"integer\",\"description\":\"Frame rate reported for the video, in frames per second.\"},\"format\":{\"type\":\"string\",\"description\":\"Media format reported for the stream.\"},\"video_codec\":{\"type\":\"string\",\"description\":\"Video codec reported for the stream.\"},\"audio_codec\":{\"type\":\"string\",\"description\":\"Audio codec reported for the stream. It may be empty.\"},\"audio_channels\":{\"type\":\"integer\",\"description\":\"Number of audio channels reported for the stream.\"},\"avg_bitrate\":{\"type\":\"integer\",\"description\":\"Average stream bitrate in bits per second.\"},\"video_bitrate\":{\"type\":\"integer\",\"description\":\"Bitrate reported for the video track, in bits per second.\"},\"audio_bitrate\":{\"type\":\"integer\",\"description\":\"Bitrate reported for the audio track, in bits per second.\"},\"quality_type\":{\"type\":\"string\",\"description\":\"Raw quality label reported for the stream.\"},\"stream_desc\":{\"type\":\"string\",\"description\":\"Description supplied by Xiaohongshu for the stream.\"},\"duration\":{\"type\":\"integer\",\"description\":\"Total stream duration in milliseconds.\"},\"video_duration\":{\"type\":\"integer\",\"description\":\"Duration of the video track in milliseconds.\"},\"audio_duration\":{\"type\":\"integer\",\"description\":\"Duration of the audio track in milliseconds. Zero can indicate that there is no audio track.\"},\"size\":{\"type\":\"integer\",\"description\":\"Stream file size in bytes.\"}}}},\"h265\":{\"type\":\"array\",\"description\":\"H.265 streams returned for the video note.\",\"items\":{\"type\":\"object\",\"description\":\"Metadata for one H.265 video stream.\",\"properties\":{\"master_url\":{\"type\":\"string\",\"description\":\"Primary URL supplied for this stream.\"},\"backup_urls\":{\"type\":\"array\",\"description\":\"Alternate URLs supplied for the stream.\",\"items\":{\"type\":\"string\",\"description\":\"Alternate stream URL.\"}},\"width\":{\"type\":\"integer\",\"description\":\"Stream width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Stream height in pixels.\"},\"fps\":{\"type\":\"integer\",\"description\":\"Frame rate reported for the video, in frames per second.\"},\"format\":{\"type\":\"string\",\"description\":\"Media format reported for the stream.\"},\"video_codec\":{\"type\":\"string\",\"description\":\"Video codec reported for the stream.\"},\"audio_codec\":{\"type\":\"string\",\"description\":\"Audio codec reported for the stream. It may be empty.\"},\"audio_channels\":{\"type\":\"integer\",\"description\":\"Number of audio channels reported for the stream.\"},\"avg_bitrate\":{\"type\":\"integer\",\"description\":\"Average stream bitrate in bits per second.\"},\"video_bitrate\":{\"type\":\"integer\",\"description\":\"Bitrate reported for the video track, in bits per second.\"},\"audio_bitrate\":{\"type\":\"integer\",\"description\":\"Bitrate reported for the audio track, in bits per second.\"},\"quality_type\":{\"type\":\"string\",\"description\":\"Raw quality label reported for the stream.\"},\"stream_desc\":{\"type\":\"string\",\"description\":\"Description supplied by Xiaohongshu for the stream.\"},\"duration\":{\"type\":\"integer\",\"description\":\"Total stream duration in milliseconds.\"},\"video_duration\":{\"type\":\"integer\",\"description\":\"Duration of the video track in milliseconds.\"},\"audio_duration\":{\"type\":\"integer\",\"description\":\"Duration of the audio track in milliseconds. Zero can indicate that there is no audio track.\"},\"size\":{\"type\":\"integer\",\"description\":\"Stream file size in bytes.\"}}}},\"h266\":{\"type\":\"array\",\"description\":\"H.266 stream list returned by Xiaohongshu. It may be empty.\"},\"av1\":{\"type\":\"array\",\"description\":\"AV1 stream list returned by Xiaohongshu. It may be empty.\"}}},\"video_id\":{\"type\":\"integer\",\"description\":\"The numeric platform video ID returned with the video metadata.\"}}},\"capa\":{\"type\":\"object\",\"description\":\"Additional metadata for the video.\",\"properties\":{\"duration\":{\"type\":\"integer\",\"description\":\"Video duration from this metadata, in seconds.\"}}},\"consumer\":{\"type\":\"object\",\"description\":\"Playback options reported for the video.\",\"properties\":{\"can_super_resolution\":{\"type\":\"boolean\",\"description\":\"Whether playback metadata reports support for super-resolution.\"}}}}}}},\"ads\":{\"type\":\"object\",\"description\":\"The advertisement information associated with an ad card, when present.\",\"properties\":{\"ads_id\":{\"type\":\"string\",\"description\":\"The identifier reported for the advertisement.\"},\"model_type\":{\"type\":\"string\",\"description\":\"The model type code reported for the advertisement.\"},\"ad_tag\":{\"type\":\"string\",\"description\":\"The display tag text returned for the advertisement.\"},\"show_tag\":{\"type\":\"boolean\",\"description\":\"Whether the platform indicates that the advertisement tag should be displayed.\"},\"note\":{\"type\":\"object\",\"description\":\"The Xiaohongshu note associated with the advertisement, when returned.\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The Xiaohongshu note ID.\"},\"type\":{\"type\":\"string\",\"description\":\"The note type reported by Xiaohongshu. Observed values include normal for image notes and video for video notes.\"},\"title\":{\"type\":\"string\",\"description\":\"The note title, when returned.\"},\"desc\":{\"type\":\"string\",\"description\":\"The note text or description returned with the search card.\"},\"timestamp\":{\"type\":\"integer\",\"description\":\"The note timestamp returned with the result, as a Unix timestamp in seconds.\"},\"update_time\":{\"type\":\"integer\",\"description\":\"The update timestamp supplied for the search result, as a Unix timestamp in milliseconds.\"},\"last_update_time\":{\"type\":\"integer\",\"description\":\"The last update time reported for the note, as a Unix timestamp in seconds. It can be zero.\"},\"liked_count\":{\"type\":\"integer\",\"description\":\"The like count reported for the search card.\"},\"nice_count\":{\"type\":\"integer\",\"description\":\"The separate nice count reported by Xiaohongshu for the note.\"},\"comments_count\":{\"type\":\"integer\",\"description\":\"The number of comments reported for the note.\"},\"collected_count\":{\"type\":\"integer\",\"description\":\"The number of saves reported for the note.\"},\"shared_count\":{\"type\":\"integer\",\"description\":\"The number of shares reported for the note.\"},\"liked\":{\"type\":\"boolean\",\"description\":\"The like status reported by Xiaohongshu for the current response context.\"},\"niced\":{\"type\":\"boolean\",\"description\":\"The separate nice status reported by Xiaohongshu for the current response context.\"},\"collected\":{\"type\":\"boolean\",\"description\":\"The save status reported by Xiaohongshu for the current response context.\"},\"has_music\":{\"type\":\"boolean\",\"description\":\"Whether the response indicates music is associated with the note.\"},\"cover_image_index\":{\"type\":\"integer\",\"description\":\"The index reported for the cover image in images_list.\"},\"note_attributes\":{\"type\":\"array\",\"description\":\"Note attributes reported by Xiaohongshu.\"},\"xsec_token\":{\"type\":\"string\",\"description\":\"The Xiaohongshu token associated with the note link, when returned.\"},\"user\":{\"type\":\"object\",\"description\":\"Author information returned for the note.\",\"properties\":{\"userid\":{\"type\":\"string\",\"description\":\"The Xiaohongshu user ID of the note author.\"},\"red_id\":{\"type\":\"string\",\"description\":\"The author&#39;s displayed Xiaohongshu account ID.\"},\"nickname\":{\"type\":\"string\",\"description\":\"The author&#39;s display name.\"},\"images\":{\"type\":\"string\",\"description\":\"The author&#39;s profile avatar URL.\"},\"red_official_verified\":{\"type\":\"boolean\",\"description\":\"The official verification flag returned for the author.\"},\"red_official_verify_type\":{\"type\":\"integer\",\"description\":\"The official verification type code reported for the author.\"},\"show_red_official_verify_icon\":{\"type\":\"boolean\",\"description\":\"Whether the platform indicates that the official verification icon should be displayed.\"}}},\"images_list\":{\"type\":\"array\",\"description\":\"Images associated with the note, which can include cover images for video notes.\",\"items\":{\"type\":\"object\",\"description\":\"An image associated with the note.\",\"properties\":{\"fileid\":{\"type\":\"string\",\"description\":\"The platform file ID of the image.\"},\"width\":{\"type\":\"integer\",\"description\":\"The width value returned for the image.\"},\"height\":{\"type\":\"integer\",\"description\":\"The height value returned for the image.\"},\"url\":{\"type\":\"string\",\"description\":\"The image URL returned for display.\"},\"original\":{\"type\":\"string\",\"description\":\"The original image URL, when returned.\"},\"url_size_large\":{\"type\":\"string\",\"description\":\"The large image URL, when returned.\"}}}}}}}}}}},\"search_request_id\":{\"type\":\"string\",\"description\":\"The search request identifier returned by Xiaohongshu.\"},\"service_status\":{\"type\":\"string\",\"description\":\"The search service status label returned in the payload.\"},\"result\":{\"type\":\"object\",\"description\":\"Additional platform result information, when returned.\",\"properties\":{\"success\":{\"type\":\"boolean\",\"description\":\"The success flag from the Xiaohongshu result information.\"},\"message\":{\"type\":\"string\",\"description\":\"The message from the Xiaohongshu result information.\"}}}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"Invalid request parameters or body\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"Invalid or inactive access token\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"Permission denied\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"Request rate or daily quota limit exceeded\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"Service temporarily unavailable\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"Global production API (default)\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/xiaohongshu/search-note/v2\"")' />

<p>Searches Xiaohongshu (RedNote) notes by keyword with page-based pagination, sorting and note-type filters. The V2 noteTime filter may return notes outside the selected time range. This endpoint does not search user accounts.</p>

## Highlights

::: warning Guidance
<p>The <code>noteTime</code> filter is not precise. For example, requesting notes from the past day may still return notes published outside that time range. For more accurate publish-time filtering, use <a href="./note-search-v4">V4</a>.</p>
:::

## Parameters

<div class="api-doc-table api-doc-table--params">

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | Yes | - | Access token for this API service. |
| <code>keyword</code> | query | <code>string</code> | Yes | - | Search keyword. |
| <code>page</code> | query | <code>integer</code> | No | <code>1</code> | Page number for pagination. Start at 1, then increment page while keeping the keyword and filters unchanged. |
| <code>sort</code> | query | <code>string</code> | No | <code>general</code> | Sort order for the result set.<br /><br><br>Available Values:<br /><br>- <code>general</code>: General<br /><br>- <code>popularity_descending</code>: Popularity Descending<br /><br>- <code>time_descending</code>: Time Descending<br /><br>- <code>comment_descending</code>: Comment Descending<br /><br>- <code>collect_descending</code>: Collect Descending |
| <code>noteType</code> | query | <code>string</code> | No | <code>_0</code> | Note type filter.<br /><br><br>Available Values:<br /><br>- <code>_0</code>: General<br /><br>- <code>_1</code>: Video<br /><br>- <code>_2</code>: Normal |
| <code>noteTime</code> | query | <code>string</code> | No | - | Note publish time filter. Results may include notes published outside the selected time range.<br /><br><br>Available Values:<br /><br>- <code>ONE_DAY</code>: Within one day<br /><br>- <code>ONE_WEEK</code>: Within a week<br /><br>- <code>HALF_YEAR</code>: Within half a year |

</div>

## Code Samples

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE'
```

```text [🤖 AI Prompt]
I want to use the "Keyword Note Search (V2)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE
API Endpoint: BASE_URL + /api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/xiaohongshu-rednote/note-search-v2-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- keyword (query): Search keyword. (Required)
- page (query): Page number for pagination. Start at 1, then increment page while keeping the keyword and filters unchanged.
- sort (query): Sort order for the result set.

Available Values:
- `general`: General
- `popularity_descending`: Popularity Descending
- `time_descending`: Time Descending
- `comment_descending`: Comment Descending
- `collect_descending`: Collect Descending
- noteType (query): Note type filter.

Available Values:
- `_0`: General
- `_1`: Video
- `_2`: Normal
- noteTime (query): Note publish time filter. Results may include notes published outside the selected time range.

Available Values:
- `ONE_DAY`: Within one day
- `ONE_WEEK`: Within a week
- `HALF_YEAR`: Within half a year

Return format: safely handle JSON or text according to the actual Content-Type.

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance
   - 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.

Please help me write a script in my preferred programming language to call this API and handle the response.
```

```python [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
```

```js [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
```

```java [☕ Java]
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
        final String url = BASE_URL + "/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
```

```go [🐹 Go]
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
```

```php [🐘 PHP]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/xiaohongshu/search-note/v2?token=YOUR_API_KEY&keyword=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/xiaohongshu-rednote/note-search-v2-en.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI Definition (JSON)]</a>
</div>

## Response Fields

Key fields in a successful response (`code = 0`).

<div class="api-doc-table api-doc-table--response">

| Field path | Type | Description |
| --- | --- | --- |
| <code>data</code> | - | Fields returned when a Xiaohongshu keyword note search response contains a result page. |
| <code>data.items</code> | <code>array</code> | The results on the requested search page. Successful responses can contain an empty list, and notes can repeat across pages. |
| <code>data.items[]</code> | <code>object</code> | A search result card. |
| <code>data.items[].model_type</code> | <code>string</code> | The card model type reported by Xiaohongshu. Observed cards include note and ads. |
| <code>data.items[].note</code> | <code>object</code> | The note associated with an ordinary note card, when present. |
| <code>data.items[].note.id</code> | <code>string</code> | The Xiaohongshu note ID. |
| <code>data.items[].note.type</code> | <code>string</code> | The note type reported by Xiaohongshu. Observed values include normal for image notes and video for video notes. |
| <code>data.items[].note.title</code> | <code>string</code> | The note title, when returned. |
| <code>data.items[].note.desc</code> | <code>string</code> | The note text or description returned with the search card. |
| <code>data.items[].note.timestamp</code> | <code>integer</code> | The note timestamp returned with the result, as a Unix timestamp in seconds. |
| <code>data.items[].note.update_time</code> | <code>integer</code> | The update timestamp supplied for the search result, as a Unix timestamp in milliseconds. |
| <code>data.items[].note.last_update_time</code> | <code>integer</code> | The last update time reported for the note, as a Unix timestamp in seconds. It can be zero. |
| <code>data.items[].note.liked_count</code> | <code>integer</code> | The like count reported for the search card. |
| <code>data.items[].note.nice_count</code> | <code>integer</code> | The separate nice count reported by Xiaohongshu for the note. |
| <code>data.items[].note.comments_count</code> | <code>integer</code> | The number of comments reported for the note. |
| <code>data.items[].note.collected_count</code> | <code>integer</code> | The number of saves reported for the note. |
| <code>data.items[].note.shared_count</code> | <code>integer</code> | The number of shares reported for the note. |
| <code>data.items[].note.liked</code> | <code>boolean</code> | The like status reported by Xiaohongshu for the current response context. |
| <code>data.items[].note.niced</code> | <code>boolean</code> | The separate nice status reported by Xiaohongshu for the current response context. |
| <code>data.items[].note.collected</code> | <code>boolean</code> | The save status reported by Xiaohongshu for the current response context. |
| <code>data.items[].note.has_music</code> | <code>boolean</code> | Whether the response indicates music is associated with the note. |
| <code>data.items[].note.video_duration</code> | <code>string</code> | The video duration returned as display text, such as 1:05. |
| <code>data.items[].note.cover_image_index</code> | <code>integer</code> | The index reported for the cover image in images_list. |
| <code>data.items[].note.note_attributes</code> | <code>array</code> | Note attributes reported by Xiaohongshu. |
| <code>data.items[].note.note_attributes[]</code> | <code>string</code> | A note attribute value as returned by Xiaohongshu. |
| <code>data.items[].note.xsec_token</code> | <code>string</code> | The Xiaohongshu token associated with the note link, when returned. |
| <code>data.items[].note.user</code> | <code>object</code> | Author information returned for the note. |
| <code>data.items[].note.user.userid</code> | <code>string</code> | The Xiaohongshu user ID of the note author. |
| <code>data.items[].note.user.red_id</code> | <code>string</code> | The author's displayed Xiaohongshu account ID. |
| <code>data.items[].note.user.nickname</code> | <code>string</code> | The author's display name. |
| <code>data.items[].note.user.images</code> | <code>string</code> | The author's profile avatar URL. |
| <code>data.items[].note.user.followed</code> | <code>boolean</code> | The follow flag returned for the author in the current response context. |
| <code>data.items[].note.user.red_official_verified</code> | <code>boolean</code> | The official verification flag returned for the author. |
| <code>data.items[].note.user.red_official_verify_type</code> | <code>integer</code> | The official verification type code reported for the author. |
| <code>data.items[].note.user.show_red_official_verify_icon</code> | <code>boolean</code> | Whether the platform indicates that the official verification icon should be displayed. |
| <code>data.items[].note.at_user_list</code> | <code>array</code> | Accounts mentioned in the note, when returned. |
| <code>data.items[].note.at_user_list[]</code> | <code>object</code> | An account mentioned in the note. |
| <code>data.items[].note.at_user_list[].user_id</code> | <code>string</code> | The Xiaohongshu user ID of the mentioned account. |
| <code>data.items[].note.at_user_list[].nickname</code> | <code>string</code> | The display name returned for the mentioned account. |
| <code>data.items[].note.images_list</code> | <code>array</code> | Images associated with the note, which can include cover images for video notes. |
| <code>data.items[].note.images_list[]</code> | <code>object</code> | An image associated with the note. |
| <code>data.items[].note.images_list[].fileid</code> | <code>string</code> | The platform file ID of the image. |
| <code>data.items[].note.images_list[].width</code> | <code>integer</code> | The width value returned for the image. |
| <code>data.items[].note.images_list[].height</code> | <code>integer</code> | The height value returned for the image. |
| <code>data.items[].note.images_list[].url</code> | <code>string</code> | The image URL returned for display. |
| <code>data.items[].note.images_list[].original</code> | <code>string</code> | The original image URL, when returned. |
| <code>data.items[].note.images_list[].url_size_large</code> | <code>string</code> | The large image URL, when returned. |
| <code>data.items[].note.images_list[].live_photo_file_id</code> | <code>string</code> | The platform file ID of the Live Photo, when returned. |
| <code>data.items[].note.images_list[].live_photo</code> | <code>object</code> | Live Photo metadata returned for the image when available. |
| <code>data.items[].note.images_list[].live_photo.media</code> | <code>object</code> | Playback metadata supplied for the Live Photo. |
| <code>data.items[].note.images_list[].live_photo.media.video_id</code> | <code>integer</code> | The numeric platform video ID returned for the Live Photo. |
| <code>data.items[].note.images_list[].live_photo.media.video</code> | <code>object</code> | Video metadata associated with the Live Photo. |
| <code>data.items[].note.images_list[].live_photo.media.video.width</code> | <code>integer</code> | Video width in pixels. |
| <code>data.items[].note.images_list[].live_photo.media.video.height</code> | <code>integer</code> | Video height in pixels. |
| <code>data.items[].note.images_list[].live_photo.media.video.duration</code> | <code>integer</code> | Video duration reported in whole seconds. |
| <code>data.items[].note.images_list[].live_photo.media.video.drm_type</code> | <code>integer</code> | Raw DRM category code reported for the video. |
| <code>data.items[].note.images_list[].live_photo.media.video.hdr_type</code> | <code>integer</code> | Raw HDR category code reported for the video. |
| <code>data.items[].note.images_list[].live_photo.media.video.stream_types</code> | <code>array</code> | Stream type codes reported for the video. |
| <code>data.items[].note.images_list[].live_photo.media.video.stream_types[]</code> | <code>integer</code> | Raw stream type code reported for the video. |
| <code>data.items[].note.images_list[].live_photo.media.stream</code> | <code>object</code> | Stream variants grouped by the codec labels returned by Xiaohongshu. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264</code> | <code>array</code> | H.264 streams returned for the Live Photo. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[]</code> | <code>object</code> | Metadata for one H.264 Live Photo stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].master_url</code> | <code>string</code> | Primary URL supplied for this stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].backup_urls</code> | <code>array</code> | Alternate URLs supplied for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].backup_urls[]</code> | <code>string</code> | Alternate stream URL. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].width</code> | <code>integer</code> | Stream width in pixels. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].height</code> | <code>integer</code> | Stream height in pixels. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].fps</code> | <code>integer</code> | Frame rate reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].format</code> | <code>string</code> | Media format reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].video_codec</code> | <code>string</code> | Video codec reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].audio_codec</code> | <code>string</code> | Audio codec reported for the stream. It may be empty. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].audio_channels</code> | <code>integer</code> | Number of audio channels reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].avg_bitrate</code> | <code>integer</code> | Average bitrate value reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].video_bitrate</code> | <code>integer</code> | Video bitrate value reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].audio_bitrate</code> | <code>integer</code> | Audio bitrate value reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].quality_type</code> | <code>string</code> | Raw quality label reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].stream_desc</code> | <code>string</code> | Description supplied by Xiaohongshu for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].duration</code> | <code>integer</code> | Stream duration value reported by Xiaohongshu. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].video_duration</code> | <code>integer</code> | Video duration value reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].audio_duration</code> | <code>integer</code> | Audio duration value reported for the stream. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h264[].size</code> | <code>integer</code> | Stream size value reported by Xiaohongshu. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h265</code> | <code>array</code> | H.265 streams returned for the Live Photo. |
| <code>data.items[].note.images_list[].live_photo.media.stream.h266</code> | <code>array</code> | H.266 stream list returned by Xiaohongshu. It may be empty. |
| <code>data.items[].note.images_list[].live_photo.media.stream.av1</code> | <code>array</code> | AV1 stream list returned by Xiaohongshu. It may be empty. |
| <code>data.items[].note.video_info_v2</code> | <code>object</code> | Video metadata and media streams returned for the note, when available. |
| <code>data.items[].note.video_info_v2.image</code> | <code>object</code> | Preview images returned for the video. |
| <code>data.items[].note.video_info_v2.image.first_frame</code> | <code>string</code> | The URL returned for the first-frame image. |
| <code>data.items[].note.video_info_v2.image.thumbnail</code> | <code>string</code> | The thumbnail image URL, when returned. |
| <code>data.items[].note.video_info_v2.image.thumbnail_dim</code> | <code>string</code> | Additional thumbnail URL supplied for the video. |
| <code>data.items[].note.video_info_v2.media</code> | <code>object</code> | Video and playback stream metadata for the note. |
| <code>data.items[].note.video_info_v2.media.video</code> | <code>object</code> | Video metadata associated with the video note. |
| <code>data.items[].note.video_info_v2.media.video.width</code> | <code>integer</code> | Video width in pixels. |
| <code>data.items[].note.video_info_v2.media.video.height</code> | <code>integer</code> | Video height in pixels. |
| <code>data.items[].note.video_info_v2.media.video.duration</code> | <code>integer</code> | Video duration reported in whole seconds. |
| <code>data.items[].note.video_info_v2.media.video.drm_type</code> | <code>integer</code> | Raw DRM category code reported for the video. |
| <code>data.items[].note.video_info_v2.media.video.hdr_type</code> | <code>integer</code> | Raw HDR category code reported for the video. |
| <code>data.items[].note.video_info_v2.media.video.stream_types</code> | <code>array</code> | Stream type codes reported for the video. |
| <code>data.items[].note.video_info_v2.media.video.stream_types[]</code> | <code>integer</code> | Raw stream type code reported for the video. |
| <code>data.items[].note.video_info_v2.media.video.md5</code> | <code>string</code> | MD5 value reported in the video metadata. |
| <code>data.items[].note.video_info_v2.media.stream</code> | <code>object</code> | Stream variants grouped by the codec labels returned by Xiaohongshu. |
| <code>data.items[].note.video_info_v2.media.stream.h264</code> | <code>array</code> | H.264 streams returned for the video note. |
| <code>data.items[].note.video_info_v2.media.stream.h264[]</code> | <code>object</code> | Metadata for one H.264 video stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].master_url</code> | <code>string</code> | Primary URL supplied for this stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].backup_urls</code> | <code>array</code> | Alternate URLs supplied for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].backup_urls[]</code> | <code>string</code> | Alternate stream URL. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].width</code> | <code>integer</code> | Stream width in pixels. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].height</code> | <code>integer</code> | Stream height in pixels. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].fps</code> | <code>integer</code> | Frame rate reported for the video, in frames per second. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].format</code> | <code>string</code> | Media format reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].video_codec</code> | <code>string</code> | Video codec reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].audio_codec</code> | <code>string</code> | Audio codec reported for the stream. It may be empty. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].audio_channels</code> | <code>integer</code> | Number of audio channels reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].avg_bitrate</code> | <code>integer</code> | Average stream bitrate in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].video_bitrate</code> | <code>integer</code> | Bitrate reported for the video track, in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].audio_bitrate</code> | <code>integer</code> | Bitrate reported for the audio track, in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].quality_type</code> | <code>string</code> | Raw quality label reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].stream_desc</code> | <code>string</code> | Description supplied by Xiaohongshu for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].duration</code> | <code>integer</code> | Total stream duration in milliseconds. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].video_duration</code> | <code>integer</code> | Duration of the video track in milliseconds. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].audio_duration</code> | <code>integer</code> | Duration of the audio track in milliseconds. Zero can indicate that there is no audio track. |
| <code>data.items[].note.video_info_v2.media.stream.h264[].size</code> | <code>integer</code> | Stream file size in bytes. |
| <code>data.items[].note.video_info_v2.media.stream.h265</code> | <code>array</code> | H.265 streams returned for the video note. |
| <code>data.items[].note.video_info_v2.media.stream.h265[]</code> | <code>object</code> | Metadata for one H.265 video stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].master_url</code> | <code>string</code> | Primary URL supplied for this stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].backup_urls</code> | <code>array</code> | Alternate URLs supplied for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].backup_urls[]</code> | <code>string</code> | Alternate stream URL. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].width</code> | <code>integer</code> | Stream width in pixels. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].height</code> | <code>integer</code> | Stream height in pixels. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].fps</code> | <code>integer</code> | Frame rate reported for the video, in frames per second. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].format</code> | <code>string</code> | Media format reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].video_codec</code> | <code>string</code> | Video codec reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].audio_codec</code> | <code>string</code> | Audio codec reported for the stream. It may be empty. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].audio_channels</code> | <code>integer</code> | Number of audio channels reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].avg_bitrate</code> | <code>integer</code> | Average stream bitrate in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].video_bitrate</code> | <code>integer</code> | Bitrate reported for the video track, in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].audio_bitrate</code> | <code>integer</code> | Bitrate reported for the audio track, in bits per second. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].quality_type</code> | <code>string</code> | Raw quality label reported for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].stream_desc</code> | <code>string</code> | Description supplied by Xiaohongshu for the stream. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].duration</code> | <code>integer</code> | Total stream duration in milliseconds. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].video_duration</code> | <code>integer</code> | Duration of the video track in milliseconds. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].audio_duration</code> | <code>integer</code> | Duration of the audio track in milliseconds. Zero can indicate that there is no audio track. |
| <code>data.items[].note.video_info_v2.media.stream.h265[].size</code> | <code>integer</code> | Stream file size in bytes. |
| <code>data.items[].note.video_info_v2.media.stream.h266</code> | <code>array</code> | H.266 stream list returned by Xiaohongshu. It may be empty. |
| <code>data.items[].note.video_info_v2.media.stream.av1</code> | <code>array</code> | AV1 stream list returned by Xiaohongshu. It may be empty. |
| <code>data.items[].note.video_info_v2.media.video_id</code> | <code>integer</code> | The numeric platform video ID returned with the video metadata. |
| <code>data.items[].note.video_info_v2.capa</code> | <code>object</code> | Additional metadata for the video. |
| <code>data.items[].note.video_info_v2.capa.duration</code> | <code>integer</code> | Video duration from this metadata, in seconds. |
| <code>data.items[].note.video_info_v2.consumer</code> | <code>object</code> | Playback options reported for the video. |
| <code>data.items[].note.video_info_v2.consumer.can_super_resolution</code> | <code>boolean</code> | Whether playback metadata reports support for super-resolution. |
| <code>data.items[].ads</code> | <code>object</code> | The advertisement information associated with an ad card, when present. |
| <code>data.items[].ads.ads_id</code> | <code>string</code> | The identifier reported for the advertisement. |
| <code>data.items[].ads.model_type</code> | <code>string</code> | The model type code reported for the advertisement. |
| <code>data.items[].ads.ad_tag</code> | <code>string</code> | The display tag text returned for the advertisement. |
| <code>data.items[].ads.show_tag</code> | <code>boolean</code> | Whether the platform indicates that the advertisement tag should be displayed. |
| <code>data.items[].ads.note</code> | <code>object</code> | The Xiaohongshu note associated with the advertisement, when returned. |
| <code>data.items[].ads.note.id</code> | <code>string</code> | The Xiaohongshu note ID. |
| <code>data.items[].ads.note.type</code> | <code>string</code> | The note type reported by Xiaohongshu. Observed values include normal for image notes and video for video notes. |
| <code>data.items[].ads.note.title</code> | <code>string</code> | The note title, when returned. |
| <code>data.items[].ads.note.desc</code> | <code>string</code> | The note text or description returned with the search card. |
| <code>data.items[].ads.note.timestamp</code> | <code>integer</code> | The note timestamp returned with the result, as a Unix timestamp in seconds. |
| <code>data.items[].ads.note.update_time</code> | <code>integer</code> | The update timestamp supplied for the search result, as a Unix timestamp in milliseconds. |
| <code>data.items[].ads.note.last_update_time</code> | <code>integer</code> | The last update time reported for the note, as a Unix timestamp in seconds. It can be zero. |
| <code>data.items[].ads.note.liked_count</code> | <code>integer</code> | The like count reported for the search card. |
| <code>data.items[].ads.note.nice_count</code> | <code>integer</code> | The separate nice count reported by Xiaohongshu for the note. |
| <code>data.items[].ads.note.comments_count</code> | <code>integer</code> | The number of comments reported for the note. |
| <code>data.items[].ads.note.collected_count</code> | <code>integer</code> | The number of saves reported for the note. |
| <code>data.items[].ads.note.shared_count</code> | <code>integer</code> | The number of shares reported for the note. |
| <code>data.items[].ads.note.liked</code> | <code>boolean</code> | The like status reported by Xiaohongshu for the current response context. |
| <code>data.items[].ads.note.niced</code> | <code>boolean</code> | The separate nice status reported by Xiaohongshu for the current response context. |
| <code>data.items[].ads.note.collected</code> | <code>boolean</code> | The save status reported by Xiaohongshu for the current response context. |
| <code>data.items[].ads.note.has_music</code> | <code>boolean</code> | Whether the response indicates music is associated with the note. |
| <code>data.items[].ads.note.cover_image_index</code> | <code>integer</code> | The index reported for the cover image in images_list. |
| <code>data.items[].ads.note.note_attributes</code> | <code>array</code> | Note attributes reported by Xiaohongshu. |
| <code>data.items[].ads.note.xsec_token</code> | <code>string</code> | The Xiaohongshu token associated with the note link, when returned. |
| <code>data.items[].ads.note.user</code> | <code>object</code> | Author information returned for the note. |
| <code>data.items[].ads.note.user.userid</code> | <code>string</code> | The Xiaohongshu user ID of the note author. |
| <code>data.items[].ads.note.user.red_id</code> | <code>string</code> | The author's displayed Xiaohongshu account ID. |
| <code>data.items[].ads.note.user.nickname</code> | <code>string</code> | The author's display name. |
| <code>data.items[].ads.note.user.images</code> | <code>string</code> | The author's profile avatar URL. |
| <code>data.items[].ads.note.user.red_official_verified</code> | <code>boolean</code> | The official verification flag returned for the author. |
| <code>data.items[].ads.note.user.red_official_verify_type</code> | <code>integer</code> | The official verification type code reported for the author. |
| <code>data.items[].ads.note.user.show_red_official_verify_icon</code> | <code>boolean</code> | Whether the platform indicates that the official verification icon should be displayed. |
| <code>data.items[].ads.note.images_list</code> | <code>array</code> | Images associated with the note, which can include cover images for video notes. |
| <code>data.items[].ads.note.images_list[]</code> | <code>object</code> | An image associated with the note. |
| <code>data.items[].ads.note.images_list[].fileid</code> | <code>string</code> | The platform file ID of the image. |
| <code>data.items[].ads.note.images_list[].width</code> | <code>integer</code> | The width value returned for the image. |
| <code>data.items[].ads.note.images_list[].height</code> | <code>integer</code> | The height value returned for the image. |
| <code>data.items[].ads.note.images_list[].url</code> | <code>string</code> | The image URL returned for display. |
| <code>data.items[].ads.note.images_list[].original</code> | <code>string</code> | The original image URL, when returned. |
| <code>data.items[].ads.note.images_list[].url_size_large</code> | <code>string</code> | The large image URL, when returned. |
| <code>data.search_request_id</code> | <code>string</code> | The search request identifier returned by Xiaohongshu. |
| <code>data.service_status</code> | <code>string</code> | The search service status label returned in the payload. |
| <code>data.result</code> | <code>object</code> | Additional platform result information, when returned. |
| <code>data.result.success</code> | <code>boolean</code> | The success flag from the Xiaohongshu result information. |
| <code>data.result.message</code> | <code>string</code> | The message from the Xiaohongshu result information. |

</div>

## Response Example

<ApiExampleSection :api='JSON.parse("\"/api/xiaohongshu/search-note/v2\"")' />

