{
  "openapi": "3.0.0",
  "info": {
    "title": "Xiaohongshu Creator Marketplace (Pugongying) Follower Distribution API (V1)",
    "version": "1.0.0",
    "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower distribution data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking."
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global (default)"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn (optional for Mainland China)"
    }
  ],
  "paths": {
    "/api/xiaohongshu-pgy/get-kol-fans-portrait/v1": {
      "get": {
        "tags": [
          "Xiaohongshu Creator Marketplace (Pugongying)"
        ],
        "summary": "Follower Distribution",
        "description": "Get Xiaohongshu Creator Marketplace (Pugongying) follower distribution 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": {
                    "fansPortrait": {
                      "cityDistribution": [
                        {
                          "distribution_data": {
                            "cnt": 11094,
                            "name": "上海"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 9124,
                            "name": "北京"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 5600,
                            "name": "广州"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 3836,
                            "name": "深圳"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 3317,
                            "name": "杭州"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 2799,
                            "name": "成都"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 2073,
                            "name": "南京"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 1970,
                            "name": "苏州"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 1762,
                            "name": "武汉"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 1347,
                            "name": "天津"
                          }
                        }
                      ],
                      "ageDistribution": [
                        {
                          "distribution_data": {
                            "cnt": 154,
                            "name": "<18"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 8191,
                            "name": "18-24"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 34008,
                            "name": "25-34"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 35355,
                            "name": "35-44"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 25974,
                            "name": ">44"
                          }
                        }
                      ],
                      "genderDistribution": [
                        {
                          "distribution_data": {
                            "cnt": 88442,
                            "name": "female"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 15241,
                            "name": "male"
                          }
                        }
                      ],
                      "interestDistribution": [
                        {
                          "distribution_data": {
                            "cnt": 32660,
                            "name": "美食"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 29446,
                            "name": "家居家装"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 21980,
                            "name": "娱乐"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 20633,
                            "name": "旅行"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 16796,
                            "name": "护肤"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 12131,
                            "name": "母婴"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 10886,
                            "name": "彩妆"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 9435,
                            "name": "教育"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 8916,
                            "name": "生活记录"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 6428,
                            "name": "健身"
                          }
                        }
                      ],
                      "provinceDistribution": [
                        {
                          "distribution_data": {
                            "cnt": 11094,
                            "name": "上海"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 10679,
                            "name": "广东"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 9124,
                            "name": "北京"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 8398,
                            "name": "江苏"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 6117,
                            "name": "浙江"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 3317,
                            "name": "山东"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 3006,
                            "name": "四川"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 2281,
                            "name": "湖北"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 2281,
                            "name": "福建"
                          }
                        },
                        {
                          "distribution_data": {
                            "cnt": 1866,
                            "name": "河南"
                          }
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": true,
        "x-order": "13002600"
      }
    }
  },
  "components": {}
}