{ "openapi": "3.0.0", "info": { "title": "Douyin Creator Marketplace (Xingtu) Follower Distribution API (V1)", "version": "1.0.0", "description": "Get Douyin Creator Marketplace (Xingtu) follower Distribution data, including audience segmentation and location and demographic breakdowns, for creator evaluation, campaign planning, and marketplace research." }, "paths": { "/api/douyin-xingtu/gw/api/data_sp/get_author_fans_distribution/v1": { "get": { "tags": [ "Douyin Creator Marketplace (Xingtu)" ], "summary": "Follower Distribution", "description": "Get Douyin Creator Marketplace (Xingtu) follower Distribution data, including audience segmentation and location and demographic breakdowns, for creator evaluation, campaign planning, and marketplace research.", "operationId": "gwApiDataSpGetAuthorFansDistributionV1", "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": "authorType", "in": "query", "description": "Author type filter.\n\nAvailable Values:\n- `FAN`: Fan\n- `DIE_HARD_FAN`: Die Hard Fan", "required": false, "schema": { "type": "string", "default": "FAN", "description": "Author relationship type", "enum": [ "FAN", "DIE_HARD_FAN" ] } } ], "responses": { "default": { "description": "default response", "content": { "application/json": { "example": { "code": 0, "data": { "base_resp": { "status_code": 0, "status_message": "" }, "distributions": [ { "description": "分布最多的3个省份广东(12%),江苏(7%),浙江(6%)", "distribution_list": [ { "distribution_key": "香港", "distribution_value": "75395" }, { "distribution_key": "福建", "distribution_value": "1357337" }, { "distribution_key": "吉林", "distribution_value": "533097" }, { "distribution_key": "江苏", "distribution_value": "2967497" }, { "distribution_key": "广西", "distribution_value": "1051394" }, { "distribution_key": "宁夏", "distribution_value": "160140" }, { "distribution_key": "台湾", "distribution_value": "35908" }, { "distribution_key": "云南", "distribution_value": "937277" }, { "distribution_key": "青海", "distribution_value": "89837" }, { "distribution_key": "辽宁", "distribution_value": "1001192" }, { "distribution_key": "山西", "distribution_value": "861436" }, { "distribution_key": "河北", "distribution_value": "1803586" }, { "distribution_key": "广东", "distribution_value": "5022865" }, { "distribution_key": "黑龙江", "distribution_value": "651852" }, { "distribution_key": "上海", "distribution_value": "911265" }, { "distribution_key": "贵州", "distribution_value": "781271" }, { "distribution_key": "四川", "distribution_value": "1993387" }, { "distribution_key": "北京", "distribution_value": "827024" }, { "distribution_key": "澳门", "distribution_value": "16560" }, { "distribution_key": "内蒙古", "distribution_value": "568038" }, { "distribution_key": "新疆", "distribution_value": "469390" }, { "distribution_key": "浙江", "distribution_value": "2531368" }, { "distribution_key": "重庆", "distribution_value": "919452" }, { "distribution_key": "山东", "distribution_value": "2524868" }, { "distribution_key": "安徽", "distribution_value": "1613291" }, { "distribution_key": "河南", "distribution_value": "2463373" }, { "distribution_key": "甘肃", "distribution_value": "459459" }, { "distribution_key": "湖南", "distribution_value": "1664129" }, { "distribution_key": "海南", "distribution_value": "269520" }, { "distribution_key": "陕西", "distribution_value": "1065132" }, { "distribution_key": "天津", "distribution_value": "451927" }, { "distribution_key": "江西", "distribution_value": "1143643" }, { "distribution_key": "西藏", "distribution_value": "45151" }, { "distribution_key": "湖北", "distribution_value": "1721824" } ], "image": [ "广东,江苏,浙江居多" ], "origin_type": 2, "type": 4, "type_display": "省份分布" }, { "description": "男性居多,占比74%", "distribution_list": [ { "distribution_key": "male", "distribution_value": "31418568" }, { "distribution_key": "female", "distribution_value": "10660924" } ], "image": [ "男性居多" ], "origin_type": 0, "type": 1, "type_display": "性别分布" }, { "description": "分布最多的1个城市广州(12%)", "distribution_list": [ { "distribution_key": "武汉", "distribution_value": "682298" }, { "distribution_key": "苏州", "distribution_value": "637191" }, { "distribution_key": "杭州", "distribution_value": "627586" }, { "distribution_key": "东莞", "distribution_value": "606157" }, { "distribution_key": "北京", "distribution_value": "827144" }, { "distribution_key": "成都", "distribution_value": "796050" }, { "distribution_key": "上海", "distribution_value": "911143" }, { "distribution_key": "深圳", "distribution_value": "859958" }, { "distribution_key": "广州", "distribution_value": "986112" }, { "distribution_key": "重庆", "distribution_value": "919450" } ], "image": [ "广州居多" ], "origin_type": 8, "type": 256, "type_display": "城市分布" }, { "description": "苹果手机占比25%, 消费能力较好", "distribution_list": [ { "distribution_key": "荣耀", "distribution_value": "3363857" }, { "distribution_key": "oppo", "distribution_value": "4107723" }, { "distribution_key": "vivo", "distribution_value": "4853690" }, { "distribution_key": "华为", "distribution_value": "5654144" }, { "distribution_key": "小米", "distribution_value": "3126675" }, { "distribution_key": "红米", "distribution_value": "2132582" }, { "distribution_key": "iPhone", "distribution_value": "10663765" }, { "distribution_key": "其他", "distribution_value": "8671024" } ], "image": [ "苹果手机较多" ], "origin_type": 3, "type": 8, "type_display": "设备品牌分布" }, { "description": "一线居多,占比30%", "distribution_list": [ { "distribution_key": "一线", "distribution_value": "11841768" }, { "distribution_key": "二线", "distribution_value": "7563644" }, { "distribution_key": "三线", "distribution_value": "8880668" }, { "distribution_key": "五线", "distribution_value": "4138108" }, { "distribution_key": "四线", "distribution_value": "6540096" } ], "image": [ "一线居多" ], "origin_type": 5, "type": 32, "type_display": "城市等级分布" }, { "description": "小镇青年居多,占比24%", "distribution_list": [ { "distribution_key": "小镇中老年", "distribution_value": "1326622" }, { "distribution_key": "精致妈妈", "distribution_value": "688416" }, { "distribution_key": "Z世代", "distribution_value": "6578576" }, { "distribution_key": "资深中产", "distribution_value": "1059584" }, { "distribution_key": "小镇青年", "distribution_value": "7103090" }, { "distribution_key": "都市银发", "distribution_value": "995294" }, { "distribution_key": "新锐白领", "distribution_value": "6010031" }, { "distribution_key": "都市蓝领", "distribution_value": "5001909" } ], "image": [ "小镇青年居多" ], "origin_type": 10, "type": 1024, "type_display": "八大人群分布" }, { "description": "分布最多的3个兴趣随拍(49%),游戏(14%),二次元(12%)", "distribution_list": [ { "distribution_key": "随拍", "distribution_value": "12993670" }, { "distribution_key": "游戏", "distribution_value": "3754214" }, { "distribution_key": "亲子", "distribution_value": "1377126" }, { "distribution_key": "二次元", "distribution_value": "3255252" }, { "distribution_key": "体育", "distribution_value": "1472028" }, { "distribution_key": "社会时政", "distribution_value": "1396900" }, { "distribution_key": "美食", "distribution_value": "1050770" }, { "distribution_key": "动物", "distribution_value": "1031695" } ], "image": [ "随拍,游戏,二次元居多" ], "origin_type": 6, "type": 64, "type_display": "兴趣分布" }, { "description": "31到40岁居多,占比30%", "distribution_list": [ { "distribution_key": "31-40", "distribution_value": "10514871" }, { "distribution_key": "24-30", "distribution_value": "8535030" }, { "distribution_key": "41-50", "distribution_value": "3533580" }, { "distribution_key": "18-23", "distribution_value": "10314969" }, { "distribution_key": "50+", "distribution_value": "2034223" } ], "image": [ "31到40岁居多" ], "origin_type": 1, "type": 2, "type_display": "年龄分布" } ], "last_update_time": "1773064801" } } } } } }, "x-order": "15002600" } } }, "components": {} }