{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) User Published Notes API (V1)",
    "version": "1.0.0",
    "description": "Get Xiaohongshu Creator Marketplace (Pugongying) user Published Notes data, including note metadata and engagement signals, for creator monitoring and campaign research."
  },
  "paths": {
    "/api/xiaohongshu-pgy/api/solar/kol/dataV2/notesDetail/v1": {
      "get": {
        "tags": [
          "Xiaohongshu Creator Marketplace (Pugongying)"
        ],
        "summary": "User Published Notes",
        "description": "Get Xiaohongshu Creator Marketplace (Pugongying) user Published Notes data, including note metadata and engagement signals, for creator monitoring and campaign research.",
        "operationId": "apiSolarKolDataV2NotesDetailV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "userId",
            "in": "query",
            "description": "KOL's user ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "advertiseSwitch",
            "in": "query",
            "description": "Advertisement filter.\n\nAvailable Values:\n- `ALL`: All notes\n- `ORGANIC_ONLY`: Organic notes only",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ALL",
              "description": "Advertisement switch",
              "enum": [
                "ALL",
                "ORGANIC_ONLY"
              ]
            }
          },
          {
            "name": "orderType",
            "in": "query",
            "description": "Sorting order.\n\nAvailable Values:\n- `LATEST`: Latest\n- `MOST_READ`: Most read\n- `MOST_INTERACT`: Most interactions",
            "required": false,
            "schema": {
              "type": "string",
              "default": "LATEST",
              "description": "Sorting order type",
              "enum": [
                "LATEST",
                "MOST_READ",
                "MOST_INTERACT"
              ]
            }
          },
          {
            "name": "noteType",
            "in": "query",
            "description": "Type of note.\n\nAvailable Values:\n- `ALL`: All types\n- `COOPERATION`: Cooperation notes\n- `PHOTO_TEXT`: Photo and Text\n- `VIDEO`: Video only",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ALL",
              "description": "Note type V2",
              "enum": [
                "ALL",
                "COOPERATION",
                "PHOTO_TEXT",
                "VIDEO"
              ]
            }
          },
          {
            "name": "isThirdPlatform",
            "in": "query",
            "description": "Whether from third-party platform.\n\nAvailable Values:\n- `NO`: No\n- `YES`: Yes",
            "required": false,
            "schema": {
              "type": "string",
              "default": "NO",
              "description": "Third platform presence",
              "enum": [
                "NO",
                "YES"
              ]
            }
          },
          {
            "name": "pageNumber",
            "in": "query",
            "description": "Page number.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "list": [
                      {
                        "readNum": 1142,
                        "likeNum": 53,
                        "collectNum": 11,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69ad5b0b000000002203ac87",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g00831tevimh558005pcp0b0ogdgr5ct59so?imageView2/2/w/540/format/jpg/q/75",
                        "title": "被儿子的女神节礼物整破防了😭",
                        "brandName": null,
                        "date": "2026-03-08",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 131324,
                        "likeNum": 791,
                        "collectNum": 200,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69abf843000000002603c375",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g2sg31tdk8qj46ee05pcp0b0ogdgr5fbfslg?imageView2/2/w/540/format/jpg/q/75",
                        "title": "你家娃也是一关灯就要喝水吗😂",
                        "brandName": null,
                        "date": "2026-03-07",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 29051,
                        "likeNum": 613,
                        "collectNum": 87,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69aab0360000000023039c1d",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g00831tcc7a4c56005pcp0b0ogdgr5cbo97g?imageView2/2/w/540/format/jpg/q/75",
                        "title": "对孩子最好的爱的教育就是爸爸爱妈妈",
                        "brandName": null,
                        "date": "2026-03-06",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 92987,
                        "likeNum": 566,
                        "collectNum": 71,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69a9581300000000260315e2",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g00831tb26t83le005pcp0b0ogdgrup8ekno?imageView2/2/w/540/format/jpg/q/75",
                        "title": "情绪这块把控的刚刚好😂",
                        "brandName": null,
                        "date": "2026-03-05",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 91927,
                        "likeNum": 408,
                        "collectNum": 60,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69a6bccd00000000220336c3",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t8gnf9b58e05pcp0b0ogdgrdkc4g5o?imageView2/2/w/540/format/jpg/q/75",
                        "title": "姐姐：我要验牌！ 团团：我只关心吃",
                        "brandName": null,
                        "date": "2026-03-03",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 85581,
                        "likeNum": 1082,
                        "collectNum": 90,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69a55e120000000026030063",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g00831t75udvh6e005pcp0b0ogdgr1e17nlg?imageView2/2/w/540/format/jpg/q/75",
                        "title": "所以说男孩子一定要多跟爸爸接触！",
                        "brandName": null,
                        "date": "2026-03-02",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 7442,
                        "likeNum": 191,
                        "collectNum": 16,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69a415610000000026033bb5",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g2sg31t5tqedd5a705pcp0b0ogdgrgj8otdo?imageView2/2/w/540/format/jpg/q/75",
                        "title": "父母恩爱才是对孩子最好的教育！",
                        "brandName": null,
                        "date": "2026-03-01",
                        "thirdReadUserNum": 0
                      },
                      {
                        "readNum": 13588,
                        "likeNum": 159,
                        "collectNum": 28,
                        "isAdvertise": false,
                        "isVideo": true,
                        "noteId": "69a17011000000002602c2d4",
                        "imgUrl": "http://ci.xiaohongshu.com/1040g00831t3b4i80l6005pcp0b0ogdgrbrcehdo?imageView2/2/w/540/format/jpg/q/75",
                        "title": "凭实力把自己养活😂",
                        "brandName": null,
                        "date": "2026-02-27",
                        "thirdReadUserNum": 0
                      }
                    ],
                    "total": 72
                  }
                }
              }
            }
          }
        },
        "x-order": "13001800"
      }
    }
  },
  "components": {}
}