{ "openapi": "3.0.0", "info": { "title": "Xiaohongshu (RedNote) Note Search API (V3)", "version": "1.0.0", "description": "Get Xiaohongshu (RedNote) note Search data, including snippets, authors, and media, for topic discovery." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "prod-global (default)" }, { "url": "http://47.117.133.51:30015", "description": "prod-cn (optional for Mainland China)" } ], "paths": { "/api/xiaohongshu/search-note/v3": { "get": { "tags": [ "Xiaohongshu (RedNote)" ], "summary": "Note Search", "description": "Get Xiaohongshu (RedNote) note Search data, including snippets, authors, and media, for topic discovery.", "operationId": "getSearchNoteV3", "parameters": [ { "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.", "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`: Hot\n- `time_descending`: New", "required": false, "schema": { "type": "string", "default": "general", "description": "Xiaohongshu Search Note Sort", "enum": [ "general", "popularity_descending", "time_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" ] } } ], "responses": { "default": { "description": "default response", "content": { "application/json": { "example": { "code": 0, "data": { "query_intent": { "search_ask_intent": false, "goodsIntent": 0, "low_supply_intent": false }, "ai_mode_enable": false, "dqa_authorized_user_by_shared": false, "is_broad_query": true, "request_dqa": 0, "request_dqa_instant": true, "search_request_id": "479005745075325f", "cur_cut_number": 0, "items": [ { "model_type": "note", "note": { "collected_count": 44, "geo_info": { "distance": "" }, "images_list": [ { "url": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i705o8hv61087m0a0h03n8?imageView2/2/w/578/format/heif/q/58|imageMogr2/strip&redImage/frame/0/enhance/4&ap=5&sc=SRH_PRV&sign=aa818726d05d85236b984b5ec9709239&t=69de03ac&origin=1", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i705o8hv61087m0a0h03n8?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=aa818726d05d85236b984b5ec9709239&t=69de03ac&origin=1", "width": 4672, "fileid": "notes_pre_post/1040g3k831ut8tahc2i705o8hv61087m0a0h03n8", "height": 7008, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i705o8hv61087m0a0h03n8" }, { "height": 7008, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i7g5o8hv61087m01kj7eh8", "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i7g5o8hv61087m01kj7eh8?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=b5694f8f89561d423fbc831849077180&t=69de03ac&origin=1", "width": 4672, "fileid": "notes_pre_post/1040g3k831ut8tahc2i7g5o8hv61087m01kj7eh8" }, { "height": 7008, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i805o8hv61087m0teb7s1o", "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i805o8hv61087m0teb7s1o?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=26600b720ac098dbc32bdd24828d18d1&t=69de03ac&origin=1", "width": 4672, "fileid": "notes_pre_post/1040g3k831ut8tahc2i805o8hv61087m0teb7s1o" }, { "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i8g5o8hv61087m0mi97dio?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=1bcf5fbe89dd74d6c771fc80d5bb686c&t=69de03ac&origin=1", "width": 4672, "fileid": "notes_pre_post/1040g3k831ut8tahc2i8g5o8hv61087m0mi97dio", "height": 7033, "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i8g5o8hv61087m0mi97dio" }, { "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i905o8hv61087m0esjrvd8", "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i905o8hv61087m0esjrvd8?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=89ef5ffff80b6ccd0c931c86a56b6aeb&t=69de03ac&origin=1", "width": 7008, "fileid": "notes_pre_post/1040g3k831ut8tahc2i905o8hv61087m0esjrvd8", "height": 3944, "need_load_original_image": false }, { "need_load_original_image": false, "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2i9g5o8hv61087m06brhato", "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2i9g5o8hv61087m06brhato?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=b5745fa1aed45d172373dcfc6a201620&t=69de03ac&origin=1", "width": 7008, "fileid": "notes_pre_post/1040g3k831ut8tahc2i9g5o8hv61087m06brhato", "height": 3944 }, { "original": "", "trace_id": "notes_pre_post/1040g3k831ut8tahc2ia05o8hv61087m07j92emg", "url": "", "url_size_large": "https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k831ut8tahc2ia05o8hv61087m07j92emg?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=0afb9077df5b69992dba5df4507c2bde&t=69de03ac&origin=1", "width": 7008, "fileid": "notes_pre_post/1040g3k831ut8tahc2ia05o8hv61087m07j92emg", "height": 3944, "need_load_original_image": false } ], "shared_count": 37, "timestamp": 1776075350, "comments_count": 312, "interaction_area": { "status": false, "text": "1370", "type": 1 }, "cover_image_index": 0, "nice_count": 0, "result_from": "", "widgets_context": "{\"flags\":{},\"author_id\":\"6111f9820000000001001ec0\",\"author_name\":\"黃宗澤Bosco\"}", "corner_tag_info": [ { "type": "ubt_sig_token", "icon": "", "location": -1, "style": 0, "text": "RAAKQk+pQeIQ73N8eGiaaM6ZaBtPxiliANL8ptmd+RqQ7UaksoI8Y4z90/DTLBnLKsn6yn9XiXP63mUGGtLHO2kqOkJquGLZ4H", "text_en": "" }, { "text_en": "Yesterday 18:15", "type": "publish_time", "icon": "http://picasso-static.xiaohongshu.com/fe-platform/e9b67af62f67d9d6cfac936f96ad10a85fdb868e.png", "location": 5, "style": 0, "text": "昨天 18:15" } ], "niced": false, "title": "許願池 🙏", "collected": false, "debug_info_str": "", "desc": "邵氏澳門一天遊！如果不只是工作，公司請我們全部人去旅行就太好了", "has_music": false, "liked_count": 1370, "type": "normal", "extract_text_enabled": 0, "user": { "show_red_official_verify_icon": false, "userid": "6111f9820000000001001ec0", "followed": false, "images": "https://sns-avatar-qc.xhscdn.com/avatar/65a514fc3b5b7c3e3f9e5f14.jpg?imageView2/2/w/80/format/jpg", "nickname": "黃宗澤Bosco", "red_official_verified": false, "red_official_verify_type": 0, "red_id": "Bosco_Wong", "track_duration": 0 }, "xsec_token": "YBOYKH8yM0QOtx7SeBSuPPxOVMj_SsU_SIvtC2OdGeky0=", "liked": false, "tag_info": { "title": "", "type": "" }, "advanced_widgets_groups": { "groups": [ { "fetch_types": [ "guos_test", "note_next_step", "second_jump_bar", "cooperate_binds", "note_collection", "rec_next_infos", "image_stickers", "image_filters", "product_review", "related_search", "cooperate_comment_component", "image_goods_cards", "ads_goods_cards", "ads_comment_component", "goods_card_v2", "image_template", "buyable_goods_card_v2", "ads_engage_bar", "challenge_card", "cooperate_engage_bar", "guide_post", "pgy_comment_component", "pgy_engage_bar", "bar_below_image", "aigc_collection", "co_produce", "widgets_ndb", "next_note_guide", "pgy_bbc_exp", "async_group", "super_activity", "widgets_enhance", "music_player", "soundtrack_player" ], "mode": 1 }, { "fetch_types": [ "guos_test", "vote_stickers", "bullet_comment_lead", "note_search_box", "interact_pk", "interact_vote", "guide_heuristic", "share_to_msg", "follow_guide", "note_share_prompt_v1", "sync_group", "group_share", "share_guide_bubble", "widgets_share", "guide_navigator" ], "mode": 0 } ] }, "id": "69dcc256000000001a0263cf", "last_update_time": 0, "note_attributes": [], "update_time": 1776075396000 } } ], "query_debug_info": { "is_forbidden": false }, "can_cut": false, "dqa_instant_sid": "klFXygDEVT", "search_dqa_new_page_exp": 1, "show_single_col": false, "strategy_info": { "query_average_impression_count": 19, "query_can_guide_to_feed": true }, "query_type": 0, "search_pull_down_opt_exp": 1, "service_status": "{\"filter\":\"not_required\",\"note\":\"success\",\"onebox\":\"not_required\",\"cost\":{\"all\":562,\"zone\":\"rcsh1\"}}" } } } } } }, "x-order": "12002100" } } }, "components": {} }