{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) Follower Profile API (V1)",
    "version": "1.0.0",
    "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower Profile data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking."
  },
  "paths": {
    "/api/xiaohongshu-pgy/get-kol-fans-portrait/v1": {
      "get": {
        "tags": [
          "Xiaohongshu Creator Marketplace (Pugongying)"
        ],
        "summary": "Follower Profile",
        "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower Profile data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking.",
        "operationId": "getKolFansPortraitV1",
        "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": "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": {
                    "ages": [
                      {
                        "group": "<18",
                        "percent": 0.020388213936601035
                      },
                      {
                        "group": "18-24",
                        "percent": 0.03546990643764837
                      },
                      {
                        "group": "25-34",
                        "percent": 0.27370478983382207
                      },
                      {
                        "group": "35-44",
                        "percent": 0.5362379555927943
                      },
                      {
                        "group": ">44",
                        "percent": 0.1341991341991342
                      }
                    ],
                    "gender": {
                      "male": 0.3287250384024577,
                      "female": 0.6712749615975423
                    },
                    "interests": [
                      {
                        "name": "美食",
                        "percent": 0.08425858389388659
                      },
                      {
                        "name": "生活记录",
                        "percent": 0.07380392792500742
                      },
                      {
                        "name": "娱乐",
                        "percent": 0.0682659318691412
                      },
                      {
                        "name": "时尚",
                        "percent": 0.06513223653996812
                      },
                      {
                        "name": "家居家装",
                        "percent": 0.050436286030742634
                      },
                      {
                        "name": "影视",
                        "percent": 0.05032822757111598
                      },
                      {
                        "name": "情感",
                        "percent": 0.04546559688791636
                      },
                      {
                        "name": "旅游",
                        "percent": 0.037847475484236975
                      },
                      {
                        "name": "美妆",
                        "percent": 0.03765837317989032
                      },
                      {
                        "name": "社科",
                        "percent": 0.03565929167679715
                      },
                      {
                        "name": "教育",
                        "percent": 0.03525407245319718
                      },
                      {
                        "name": "母婴",
                        "percent": 0.033444093254450656
                      },
                      {
                        "name": "健康",
                        "percent": 0.03198530404949077
                      },
                      {
                        "name": "兴趣爱好",
                        "percent": 0.029310857173730987
                      },
                      {
                        "name": "汽车",
                        "percent": 0.02669043952778453
                      },
                      {
                        "name": "宠物",
                        "percent": 0.024151065726558067
                      },
                      {
                        "name": "职场",
                        "percent": 0.023961963422211418
                      },
                      {
                        "name": "健身减肥",
                        "percent": 0.02242213037253154
                      },
                      {
                        "name": "素材",
                        "percent": 0.022287057297998215
                      },
                      {
                        "name": "人文",
                        "percent": 0.01931544965826512
                      }
                    ],
                    "provinces": [
                      {
                        "name": "广东",
                        "percent": 0.1189586597565385
                      },
                      {
                        "name": "江苏",
                        "percent": 0.0689405809328673
                      },
                      {
                        "name": "山东",
                        "percent": 0.06845847896830179
                      },
                      {
                        "name": "海外",
                        "percent": 0.06074484753525371
                      },
                      {
                        "name": "北京",
                        "percent": 0.05146438471736772
                      },
                      {
                        "name": "浙江",
                        "percent": 0.05134385922622635
                      },
                      {
                        "name": "河南",
                        "percent": 0.046402314089429915
                      },
                      {
                        "name": "河北",
                        "percent": 0.04061709051464385
                      },
                      {
                        "name": "湖北",
                        "percent": 0.039050259129805955
                      },
                      {
                        "name": "四川",
                        "percent": 0.036037121851271545
                      },
                      {
                        "name": "辽宁",
                        "percent": 0.03579607086898879
                      },
                      {
                        "name": "上海",
                        "percent": 0.03350608653730264
                      },
                      {
                        "name": "福建",
                        "percent": 0.030372423767626854
                      },
                      {
                        "name": "湖南",
                        "percent": 0.0301313727853441
                      },
                      {
                        "name": "陕西",
                        "percent": 0.028926117873930336
                      },
                      {
                        "name": "安徽",
                        "percent": 0.02711823550680969
                      },
                      {
                        "name": "广西",
                        "percent": 0.023864047245992528
                      },
                      {
                        "name": "云南",
                        "percent": 0.022899843316861516
                      },
                      {
                        "name": "山西",
                        "percent": 0.02048933349403399
                      },
                      {
                        "name": "重庆",
                        "percent": 0.018922502109196094
                      },
                      {
                        "name": "天津",
                        "percent": 0.017355670724358202
                      },
                      {
                        "name": "江西",
                        "percent": 0.017114619742075447
                      },
                      {
                        "name": "内蒙古",
                        "percent": 0.01373990599011691
                      },
                      {
                        "name": "新疆",
                        "percent": 0.013137278534410027
                      },
                      {
                        "name": "吉林",
                        "percent": 0.012655176569844523
                      },
                      {
                        "name": "黑龙江",
                        "percent": 0.01205254911413764
                      },
                      {
                        "name": "台湾",
                        "percent": 0.01108834518500663
                      },
                      {
                        "name": "香港",
                        "percent": 0.010726768711582499
                      },
                      {
                        "name": "贵州",
                        "percent": 0.009762564782451489
                      },
                      {
                        "name": "甘肃",
                        "percent": 0.009521513800168736
                      },
                      {
                        "name": "海南",
                        "percent": 0.008677835362179101
                      },
                      {
                        "name": "宁夏",
                        "percent": 0.0034952392430999154
                      },
                      {
                        "name": "澳门",
                        "percent": 0.002651560805110281
                      },
                      {
                        "name": "青海",
                        "percent": 0.0020489333494033988
                      },
                      {
                        "name": "中国",
                        "percent": 0.001205254911413764
                      },
                      {
                        "name": "西藏",
                        "percent": 0.0007231529468482585
                      }
                    ],
                    "cities": [
                      {
                        "name": "北京",
                        "percent": 0.05146438471736772
                      },
                      {
                        "name": "上海",
                        "percent": 0.03350608653730264
                      },
                      {
                        "name": "深圳",
                        "percent": 0.029046643365071713
                      },
                      {
                        "name": "广州",
                        "percent": 0.02579245510425455
                      },
                      {
                        "name": "成都",
                        "percent": 0.020971435458599495
                      },
                      {
                        "name": "重庆",
                        "percent": 0.018922502109196094
                      },
                      {
                        "name": "武汉",
                        "percent": 0.018560925635771965
                      },
                      {
                        "name": "天津",
                        "percent": 0.017355670724358202
                      },
                      {
                        "name": "苏州",
                        "percent": 0.017355670724358202
                      }
                    ],
                    "devices": [
                      {
                        "name": "apple inc.",
                        "desc": "苹果",
                        "percent": 0.4340122936000964
                      },
                      {
                        "name": "huawei",
                        "desc": "华为",
                        "percent": 0.2189948174038809
                      },
                      {
                        "name": "honor",
                        "desc": "honor",
                        "percent": 0.07810051825961191
                      },
                      {
                        "name": "xiaomi",
                        "desc": "小米",
                        "percent": 0.0776184162950464
                      },
                      {
                        "name": "vivo",
                        "desc": "vivo",
                        "percent": 0.07725683982162228
                      },
                      {
                        "name": "oppo",
                        "desc": "oppo",
                        "percent": 0.07159214173797758
                      },
                      {
                        "name": "samsung",
                        "desc": "三星",
                        "percent": 0.013016753043268652
                      },
                      {
                        "name": "oneplus",
                        "desc": "oneplus",
                        "percent": 0.011208870676148005
                      },
                      {
                        "name": "realme",
                        "desc": "realme",
                        "percent": 0.006508376521634326
                      },
                      {
                        "name": "ptac",
                        "desc": "ptac",
                        "percent": 0.0019284078582620225
                      }
                    ],
                    "dateKey": "2026-03-08"
                  }
                }
              }
            }
          }
        },
        "deprecated": true,
        "x-order": "13002600"
      }
    }
  },
  "components": {}
}