{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu (RedNote) Note Search API (V4)",
    "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/v4": {
      "get": {
        "tags": [
          "Xiaohongshu (RedNote)"
        ],
        "summary": "Note Search",
        "description": "Get Xiaohongshu (RedNote) note Search data, including snippets, authors, and media, for topic discovery.",
        "operationId": "getApiXiaohongshuSearchNoteV4",
        "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": "searchId",
            "in": "query",
            "description": "Search session ID from the previous response data.api_info.search_id.",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "sessionId",
            "in": "query",
            "description": "Session ID from the previous response data.api_info.session_id.",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "sortType",
            "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- `不限`: No Limit\n- `视频笔记`: Video Note\n- `普通笔记`: Normal Note",
            "required": false,
            "schema": {
              "type": "string",
              "default": "不限",
              "description": "Xiaohongshu KANG Search Note Type",
              "enum": [
                "不限",
                "视频笔记",
                "普通笔记"
              ]
            }
          },
          {
            "name": "timeFilter",
            "in": "query",
            "description": "Publish time filter.\n\nAvailable Values:\n- `不限`: No Limit\n- `一天内`: Within one day\n- `一周内`: Within one week\n- `半年内`: Within half a year",
            "required": false,
            "schema": {
              "type": "string",
              "default": "不限",
              "description": "Xiaohongshu KANG Search Note Time Filter",
              "enum": [
                "不限",
                "一天内",
                "一周内",
                "半年内"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "0",
                        "100",
                        "101",
                        "202",
                        "300",
                        "301",
                        "302",
                        "303",
                        "400",
                        "500",
                        "600",
                        "601"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    },
                    "recordTime": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "12001120",
        "x-recommended": true,
        "x-api-version": "v4",
        "x-highlights": [
          {
            "type": "tip",
            "content": "This is a mobile app version endpoint. Search results are more accurate."
          }
        ]
      }
    }
  },
  "components": {}
}