{
  "openapi": "3.0.0",
  "info": {
    "title": "小红书蒲公英笔记表现率 API (V1)",
    "version": "1.0.0",
    "description": "获取小红书蒲公英笔记表现率数据，包括核心指标、趋势信号和表现指标，用于内容效率分析、创作者对标和活动策划。"
  },
  "paths": {
    "/api/xiaohongshu-pgy/get-kol-note-rate/v1": {
      "get": {
        "tags": [
          "小红书蒲公英"
        ],
        "summary": "笔记表现率",
        "description": "获取小红书蒲公英笔记表现率数据，包括核心指标、趋势信号和表现指标，用于内容效率分析、创作者对标和活动策划。",
        "operationId": "getKolNoteRateV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "用户鉴权令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kolId",
            "in": "query",
            "description": "KOL ID。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dateType",
            "in": "query",
            "description": "日期类型。\n\n可用值：\n- `_1`: 最近30天\n- `_2`: 最近90天",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_1",
              "description": "Note rate date range type",
              "enum": [
                "_1",
                "_2"
              ]
            }
          },
          {
            "name": "noteType",
            "in": "query",
            "description": "笔记类型。\n\n可用值：\n- `_1`: 图文\n- `_2`: 视频\n- `_3`: 图文和视频",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_3",
              "description": "Note rate note type filter",
              "enum": [
                "_1",
                "_2",
                "_3"
              ]
            }
          },
          {
            "name": "adSwitch",
            "in": "query",
            "description": "广告过滤。\n\n可用值：\n- `_1`: 全流量（所有笔记）\n- `_0`: 自然流量（自然笔记）",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_1",
              "description": "Note rate advertisement filter",
              "enum": [
                "_1",
                "_0"
              ]
            }
          },
          {
            "name": "business",
            "in": "query",
            "description": "业务类型。\n\n可用值：\n- `_0`: 普通笔记\n- `_1`: 合作笔记",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_0",
              "description": "Note rate business type",
              "enum": [
                "_0",
                "_1"
              ]
            }
          },
          {
            "name": "acceptCache",
            "in": "query",
            "description": "启用缓存。",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "default": {
            "description": "默认响应",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "noteNumber": 0,
                    "videoNoteNumber": 0,
                    "hundredLikePercent": "0.0",
                    "thousandLikePercent": "0.0",
                    "noteType": [],
                    "tradeNames": null,
                    "impMedian": 0,
                    "impMedianBeyondRate": "0.0",
                    "readMedian": 0,
                    "readMedianBeyondRate": "0.0",
                    "interactionMedian": 0,
                    "interactionRate": "0.0",
                    "interactionBeyondRate": "0.0",
                    "likeMedian": 0,
                    "collectMedian": 0,
                    "commentMedian": 0,
                    "shareMedian": 0,
                    "videoFullViewRate": "0.0",
                    "videoFullViewBeyondRate": "0.0",
                    "picture3sViewRate": "0.0",
                    "notes": null,
                    "pagePercentVo": null,
                    "longTermCommonNoteVo": {
                      "startPublishTime": "2025-07-12",
                      "endPublishTime": "2025-09-10",
                      "noteNumber": 0,
                      "recentReadNum": null,
                      "recentReadBeyondRate": null,
                      "longTermReadNum": null,
                      "longTermReadBeyondRate": null,
                      "recentSearchPagePercent": null,
                      "recentFindPagePercent": null,
                      "recentKolHomePagePercent": null,
                      "recentFollowPagePercent": null,
                      "recentOtherPagePercent": null,
                      "longTermSearchPagePercent": null,
                      "longTermFindPagePercent": null,
                      "longTermKolHomePagePercent": null,
                      "longTermFollowPagePercent": null,
                      "longTermOtherPagePercent": null
                    },
                    "longTermCooperateNoteVo": {
                      "startPublishTime": "2025-07-12",
                      "endPublishTime": "2025-09-10",
                      "noteNumber": 0,
                      "recentReadNum": null,
                      "recentReadBeyondRate": null,
                      "longTermReadNum": null,
                      "longTermReadBeyondRate": null,
                      "recentSearchPagePercent": null,
                      "recentFindPagePercent": null,
                      "recentKolHomePagePercent": null,
                      "recentFollowPagePercent": null,
                      "recentOtherPagePercent": null,
                      "longTermSearchPagePercent": null,
                      "longTermFindPagePercent": null,
                      "longTermKolHomePagePercent": null,
                      "longTermFollowPagePercent": null,
                      "longTermOtherPagePercent": null
                    },
                    "mengagementNum": 0,
                    "mfollowCnt": 0,
                    "mEngagementNum": 0,
                    "mFollowCnt": 0
                  }
                }
              }
            }
          }
        },
        "deprecated": true,
        "x-order": "13002500"
      }
    }
  },
  "components": {}
}