抖音星图 API - 作者受众分布 (V1)
prod-global
GET
/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1
获取作者的受众人口统计数据。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
oAuthorId | query | string | 是 | 作者唯一ID。 |
platform | query | string | 否 | 平台类型。 可用值： - SHORT_VIDEO: 短视频- LIVE_STREAMING: 直播- PICTURE_TEXT: 图文- SHORT_DRAMA: 短剧 |
linkType | query | string | 否 | 链接类型过滤器。 可用值： - CONNECTED: 已连接- AWARE: 已知晓- INTERESTED: 感兴趣- LIKE: 喜欢- FOLLOW: 关注 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE"text
我想使用 Just One API 提供的“作者受众分布 (V1)”接口。
接口地址: https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/author-audience-distribution-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- oAuthorId (query): 作者唯一ID。 (必填)
- platform (query): 平台类型。
可用值：
- `SHORT_VIDEO`: 短视频
- `LIVE_STREAMING`: 直播
- `PICTURE_TEXT`: 图文
- `SHORT_DRAMA`: 短剧
- linkType (query): 链接类型过滤器。
可用值：
- `CONNECTED`: 已连接
- `AWARE`: 已知晓
- `INTERESTED`: 感兴趣
- `LIKE`: 喜欢
- `FOLLOW`: 关注
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_audience_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"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"
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。