{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) Creator Note List API (V1)",
    "version": "1.0.0",
    "description": "Get Xiaohongshu Creator Marketplace (Pugongying) creator Note List data, including content metadata, publish time, and engagement indicators, for content analysis."
  },
  "paths": {
    "/api/xiaohongshu-pgy/get-kol-note-list/v1": {
      "get": {
        "tags": [
          "Xiaohongshu Creator Marketplace (Pugongying)"
        ],
        "summary": "Creator Note List",
        "description": "Get Xiaohongshu Creator Marketplace (Pugongying) creator Note List data, including content metadata, publish time, and engagement indicators, for content analysis.",
        "operationId": "getKolNoteListV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kolId",
            "in": "query",
            "description": "KOL ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "adSwitch",
            "in": "query",
            "description": "Ad filter.\n\nAvailable Values:\n- `_1`: Full traffic (All notes)\n- `_0`: Natural traffic (Organic notes)",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Note list advertisement filter",
              "enum": [
                "_1",
                "_0"
              ]
            }
          },
          {
            "name": "orderType",
            "in": "query",
            "description": "Sorting order.\n\nAvailable Values:\n- `_1`: Latest\n- `_2`: Most read\n- `_3`: Most interactions",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Note list sorting order",
              "enum": [
                "_1",
                "_2",
                "_3"
              ]
            }
          },
          {
            "name": "noteType",
            "in": "query",
            "description": "Note type.\n\nAvailable Values:\n- `_1`: Photo and Text notes\n- `_2`: Video notes\n- `_3`: Cooperation notes\n- `_4`: All types",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_4",
              "description": "Note list type filter",
              "enum": [
                "_1",
                "_2",
                "_3",
                "_4"
              ]
            }
          },
          {
            "name": "acceptCache",
            "in": "query",
            "description": "Enable cache.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "list": [],
                    "total": 0
                  }
                }
              }
            }
          }
        },
        "x-order": "13002900"
      }
    }
  },
  "components": {}
}