{
  "openapi": "3.0.0",
  "info": {
    "title": "Douyin Creator Marketplace (Xingtu) Audience Distribution API (V1)",
    "version": "1.0.0",
    "description": "Get Douyin Creator Marketplace (Xingtu) audience Distribution data, including demographic and interest-based audience segmentation, for creator evaluation, campaign planning, and marketplace research."
  },
  "paths": {
    "/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1": {
      "get": {
        "tags": [
          "Douyin Creator Marketplace (Xingtu)"
        ],
        "summary": "Audience Distribution",
        "description": "Get Douyin Creator Marketplace (Xingtu) audience Distribution data, including demographic and interest-based audience segmentation, for creator evaluation, campaign planning, and marketplace research.",
        "operationId": "gwApiDataSpAuthorAudienceDistributionV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "oAuthorId",
            "in": "query",
            "description": "Author's unique ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "description": "Platform type.\n\nAvailable Values:\n- `SHORT_VIDEO`: Short video\n- `LIVE_STREAMING`: Live streaming\n- `PICTURE_TEXT`: Picture and text\n- `SHORT_DRAMA`: Short drama",
            "required": false,
            "schema": {
              "type": "string",
              "default": "SHORT_VIDEO",
              "description": "Platform type",
              "enum": [
                "SHORT_VIDEO",
                "LIVE_STREAMING",
                "PICTURE_TEXT",
                "SHORT_DRAMA"
              ]
            }
          },
          {
            "name": "linkType",
            "in": "query",
            "description": "Link type filter.\n\nAvailable Values:\n- `CONNECTED`: Connected\n- `AWARE`: Aware\n- `INTERESTED`: Interested\n- `LIKE`: Like\n- `FOLLOW`: Follow",
            "required": false,
            "schema": {
              "type": "string",
              "default": "CONNECTED",
              "description": "Link type",
              "enum": [
                "CONNECTED",
                "AWARE",
                "INTERESTED",
                "LIKE",
                "FOLLOW"
              ]
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "base_resp": {
                      "status_code": 0,
                      "status_message": ""
                    },
                    "distributions": [
                      {
                        "description": "小镇青年居多,占比27%",
                        "distribution_list": [
                          {
                            "distribution_key": "Z世代",
                            "distribution_value": "2109294"
                          },
                          {
                            "distribution_key": "都市银发",
                            "distribution_value": "441648"
                          },
                          {
                            "distribution_key": "资深中产",
                            "distribution_value": "298831"
                          },
                          {
                            "distribution_key": "小镇中老年",
                            "distribution_value": "478309"
                          },
                          {
                            "distribution_key": "小镇青年",
                            "distribution_value": "2594111"
                          },
                          {
                            "distribution_key": "都市蓝领",
                            "distribution_value": "1586769"
                          },
                          {
                            "distribution_key": "新锐白领",
                            "distribution_value": "1766809"
                          },
                          {
                            "distribution_key": "精致妈妈",
                            "distribution_value": "221550"
                          }
                        ],
                        "image": [
                          "小镇青年居多"
                        ],
                        "origin_type": 10,
                        "type": 1024,
                        "type_display": "八大人群分布"
                      },
                      {
                        "description": "分布最多的3个省份广东(13%),江苏(7%),浙江(7%)",
                        "distribution_list": [
                          {
                            "distribution_key": "河南",
                            "distribution_value": "611566"
                          },
                          {
                            "distribution_key": "河北",
                            "distribution_value": "412996"
                          },
                          {
                            "distribution_key": "湖南",
                            "distribution_value": "372769"
                          },
                          {
                            "distribution_key": "重庆",
                            "distribution_value": "200338"
                          },
                          {
                            "distribution_key": "宁夏",
                            "distribution_value": "38582"
                          },
                          {
                            "distribution_key": "贵州",
                            "distribution_value": "201955"
                          },
                          {
                            "distribution_key": "北京",
                            "distribution_value": "195647"
                          },
                          {
                            "distribution_key": "上海",
                            "distribution_value": "217988"
                          },
                          {
                            "distribution_key": "新疆",
                            "distribution_value": "126645"
                          },
                          {
                            "distribution_key": "湖北",
                            "distribution_value": "472526"
                          },
                          {
                            "distribution_key": "山西",
                            "distribution_value": "205850"
                          },
                          {
                            "distribution_key": "青海",
                            "distribution_value": "22091"
                          },
                          {
                            "distribution_key": "陕西",
                            "distribution_value": "298772"
                          },
                          {
                            "distribution_key": "四川",
                            "distribution_value": "452246"
                          },
                          {
                            "distribution_key": "安徽",
                            "distribution_value": "410511"
                          },
                          {
                            "distribution_key": "广西",
                            "distribution_value": "260548"
                          },
                          {
                            "distribution_key": "西藏",
                            "distribution_value": "20104"
                          },
                          {
                            "distribution_key": "香港",
                            "distribution_value": "11445"
                          },
                          {
                            "distribution_key": "内蒙古",
                            "distribution_value": "113857"
                          },
                          {
                            "distribution_key": "浙江",
                            "distribution_value": "712968"
                          },
                          {
                            "distribution_key": "澳门",
                            "distribution_value": "2819"
                          },
                          {
                            "distribution_key": "天津",
                            "distribution_value": "103827"
                          },
                          {
                            "distribution_key": "江苏",
                            "distribution_value": "722724"
                          },
                          {
                            "distribution_key": "海南",
                            "distribution_value": "73707"
                          },
                          {
                            "distribution_key": "广东",
                            "distribution_value": "1256860"
                          },
                          {
                            "distribution_key": "甘肃",
                            "distribution_value": "119382"
                          },
                          {
                            "distribution_key": "吉林",
                            "distribution_value": "103763"
                          },
                          {
                            "distribution_key": "山东",
                            "distribution_value": "547508"
                          },
                          {
                            "distribution_key": "台湾",
                            "distribution_value": "5801"
                          },
                          {
                            "distribution_key": "福建",
                            "distribution_value": "342116"
                          },
                          {
                            "distribution_key": "辽宁",
                            "distribution_value": "207672"
                          },
                          {
                            "distribution_key": "云南",
                            "distribution_value": "252848"
                          },
                          {
                            "distribution_key": "江西",
                            "distribution_value": "310287"
                          },
                          {
                            "distribution_key": "黑龙江",
                            "distribution_value": "123809"
                          }
                        ],
                        "image": [
                          "广东,江苏,浙江居多"
                        ],
                        "origin_type": 2,
                        "type": 4,
                        "type_display": "省份分布"
                      },
                      {
                        "description": "分布最多的3个兴趣随拍(49%),二次元(13%),游戏(12%)",
                        "distribution_list": [
                          {
                            "distribution_key": "随拍",
                            "distribution_value": "3841879"
                          },
                          {
                            "distribution_key": "二次元",
                            "distribution_value": "1076709"
                          },
                          {
                            "distribution_key": "游戏",
                            "distribution_value": "955457"
                          },
                          {
                            "distribution_key": "社会时政",
                            "distribution_value": "481998"
                          },
                          {
                            "distribution_key": "亲子",
                            "distribution_value": "418445"
                          },
                          {
                            "distribution_key": "体育",
                            "distribution_value": "400978"
                          },
                          {
                            "distribution_key": "美食",
                            "distribution_value": "294718"
                          },
                          {
                            "distribution_key": "剧情",
                            "distribution_value": "281328"
                          }
                        ],
                        "image": [
                          "随拍,二次元,游戏居多"
                        ],
                        "origin_type": 6,
                        "type": 64,
                        "type_display": "兴趣分布"
                      },
                      {
                        "description": "男性居多,占比79%",
                        "distribution_list": [
                          {
                            "distribution_key": "female",
                            "distribution_value": "1968283"
                          },
                          {
                            "distribution_key": "male",
                            "distribution_value": "7712817"
                          }
                        ],
                        "image": [
                          "男性居多"
                        ],
                        "origin_type": 0,
                        "type": 1,
                        "type_display": "性别分布"
                      },
                      {
                        "description": "分布最多的1个城市广州(12%)",
                        "distribution_list": [
                          {
                            "distribution_key": "深圳",
                            "distribution_value": "221900"
                          },
                          {
                            "distribution_key": "杭州",
                            "distribution_value": "161682"
                          },
                          {
                            "distribution_key": "东莞",
                            "distribution_value": "165213"
                          },
                          {
                            "distribution_key": "苏州",
                            "distribution_value": "169547"
                          },
                          {
                            "distribution_key": "成都",
                            "distribution_value": "185635"
                          },
                          {
                            "distribution_key": "北京",
                            "distribution_value": "195647"
                          },
                          {
                            "distribution_key": "广州",
                            "distribution_value": "238932"
                          },
                          {
                            "distribution_key": "重庆",
                            "distribution_value": "200338"
                          },
                          {
                            "distribution_key": "上海",
                            "distribution_value": "217988"
                          },
                          {
                            "distribution_key": "武汉",
                            "distribution_value": "206652"
                          }
                        ],
                        "image": [
                          "广州居多"
                        ],
                        "origin_type": 8,
                        "type": 256,
                        "type_display": "城市分布"
                      },
                      {
                        "description": "一线居多,占比30%",
                        "distribution_list": [
                          {
                            "distribution_key": "五线",
                            "distribution_value": "998693"
                          },
                          {
                            "distribution_key": "四线",
                            "distribution_value": "1566423"
                          },
                          {
                            "distribution_key": "二线",
                            "distribution_value": "1897740"
                          },
                          {
                            "distribution_key": "三线",
                            "distribution_value": "2124384"
                          },
                          {
                            "distribution_key": "一线",
                            "distribution_value": "2945440"
                          }
                        ],
                        "image": [
                          "一线居多"
                        ],
                        "origin_type": 5,
                        "type": 32,
                        "type_display": "城市等级分布"
                      },
                      {
                        "description": "18到23岁居多,占比30%",
                        "distribution_list": [
                          {
                            "distribution_key": "50+",
                            "distribution_value": "552849"
                          },
                          {
                            "distribution_key": "41-50",
                            "distribution_value": "557961"
                          },
                          {
                            "distribution_key": "24-30",
                            "distribution_value": "2246253"
                          },
                          {
                            "distribution_key": "31-40",
                            "distribution_value": "2425550"
                          },
                          {
                            "distribution_key": "18-23",
                            "distribution_value": "2503346"
                          }
                        ],
                        "image": [
                          "18到23岁居多"
                        ],
                        "origin_type": 1,
                        "type": 2,
                        "type_display": "年龄分布"
                      },
                      {
                        "description": "苹果手机占比29%, 消费能力较好",
                        "distribution_list": [
                          {
                            "distribution_key": "iPhone",
                            "distribution_value": "2834114"
                          },
                          {
                            "distribution_key": "oppo",
                            "distribution_value": "820047"
                          },
                          {
                            "distribution_key": "红米",
                            "distribution_value": "675417"
                          },
                          {
                            "distribution_key": "小米",
                            "distribution_value": "713122"
                          },
                          {
                            "distribution_key": "华为",
                            "distribution_value": "1359329"
                          },
                          {
                            "distribution_key": "荣耀",
                            "distribution_value": "841232"
                          },
                          {
                            "distribution_key": "vivo",
                            "distribution_value": "982618"
                          },
                          {
                            "distribution_key": "其他",
                            "distribution_value": "1459977"
                          }
                        ],
                        "image": [
                          "苹果手机较多"
                        ],
                        "origin_type": 3,
                        "type": 8,
                        "type_display": "设备品牌分布"
                      }
                    ],
                    "last_update_time": "1773064801"
                  }
                }
              }
            }
          }
        },
        "x-order": "15001700"
      }
    }
  },
  "components": {}
}