{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) Follower Growth Trend API (V1)",
    "version": "1.0.0",
    "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower Growth Trend data, including historical audience changes over time, for creator evaluation, campaign planning, and creator benchmarking."
  },
  "paths": {
    "/api/xiaohongshu-pgy/get-kol-fans-trend/v1": {
      "get": {
        "tags": [
          "Xiaohongshu Creator Marketplace (Pugongying)"
        ],
        "summary": "Follower Growth Trend",
        "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower Growth Trend data, including historical audience changes over time, for creator evaluation, campaign planning, and creator benchmarking.",
        "operationId": "getKolFansTrendV1",
        "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": "dateType",
            "in": "query",
            "description": "Date type.\n\nAvailable Values:\n- `_1`: Last 30 days\n- `_2`: Last 60 days",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Fans trend date range type",
              "enum": [
                "_1",
                "_2"
              ]
            }
          },
          {
            "name": "increaseType",
            "in": "query",
            "description": "Increase type.\n\nAvailable Values:\n- `_1`: Total fans\n- `_2`: New fans increase",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Fans growth increase type",
              "enum": [
                "_1",
                "_2"
              ]
            }
          },
          {
            "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": {
                    "fansNumInc": -11,
                    "fansNumIncRate": -0.0013048635824436537,
                    "list": [
                      {
                        "num": 8430,
                        "dateKey": "2026-02-07"
                      },
                      {
                        "num": 8431,
                        "dateKey": "2026-02-08"
                      },
                      {
                        "num": 8430,
                        "dateKey": "2026-02-09"
                      },
                      {
                        "num": 8429,
                        "dateKey": "2026-02-10"
                      },
                      {
                        "num": 8429,
                        "dateKey": "2026-02-11"
                      },
                      {
                        "num": 8429,
                        "dateKey": "2026-02-12"
                      },
                      {
                        "num": 8428,
                        "dateKey": "2026-02-13"
                      },
                      {
                        "num": 8428,
                        "dateKey": "2026-02-14"
                      },
                      {
                        "num": 8428,
                        "dateKey": "2026-02-15"
                      },
                      {
                        "num": 8428,
                        "dateKey": "2026-02-16"
                      },
                      {
                        "num": 8427,
                        "dateKey": "2026-02-17"
                      },
                      {
                        "num": 8426,
                        "dateKey": "2026-02-18"
                      },
                      {
                        "num": 8424,
                        "dateKey": "2026-02-19"
                      },
                      {
                        "num": 8424,
                        "dateKey": "2026-02-20"
                      },
                      {
                        "num": 8424,
                        "dateKey": "2026-02-21"
                      },
                      {
                        "num": 8422,
                        "dateKey": "2026-02-22"
                      },
                      {
                        "num": 8422,
                        "dateKey": "2026-02-23"
                      },
                      {
                        "num": 8420,
                        "dateKey": "2026-02-24"
                      },
                      {
                        "num": 8420,
                        "dateKey": "2026-02-25"
                      },
                      {
                        "num": 8420,
                        "dateKey": "2026-02-26"
                      },
                      {
                        "num": 8421,
                        "dateKey": "2026-02-27"
                      },
                      {
                        "num": 8422,
                        "dateKey": "2026-02-28"
                      },
                      {
                        "num": 8421,
                        "dateKey": "2026-03-01"
                      },
                      {
                        "num": 8421,
                        "dateKey": "2026-03-02"
                      },
                      {
                        "num": 8419,
                        "dateKey": "2026-03-03"
                      },
                      {
                        "num": 8419,
                        "dateKey": "2026-03-04"
                      },
                      {
                        "num": 8418,
                        "dateKey": "2026-03-05"
                      },
                      {
                        "num": 8419,
                        "dateKey": "2026-03-06"
                      },
                      {
                        "num": 8419,
                        "dateKey": "2026-03-07"
                      },
                      {
                        "num": 8419,
                        "dateKey": "2026-03-08"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "deprecated": true,
        "x-order": "13002800"
      }
    }
  },
  "components": {}
}