抖音星图 API - KOL个人资料 (V1)
此接口已过期
此接口已过时，可能会在未来的版本中被移除。请尽快迁移到新版本。
prod-global
GET
/api/douyin-xingtu/get-kol-info/v1
获取KOL个人资料信息（旧版接口）。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
kolId | query | string | 是 | KOL ID。 |
platformChannel | query | string | 否 | 平台渠道。 可用值： - _1: 短视频- _10: 直播 |
acceptCache | query | boolean | 否 | 启用缓存。 |
代码示例
💡 环境说明
默认示例使用 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/get-kol-info/v1?token=YOUR_API_KEY&kolId=VALUE"text
我想使用 Just One API 提供的“KOL个人资料 (V1) [已弃用]”接口。
接口地址: https://api.justoneapi.com/api/douyin-xingtu/get-kol-info/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/kol-profile-v1-deprecated-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- kolId (query): KOL ID。 (必填)
- platformChannel (query): 平台渠道。
可用值：
- `_1`: 短视频
- `_10`: 直播
- acceptCache (query): 启用缓存。
返回格式: 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/get-kol-info/v1?token=YOUR_API_KEY&kolId=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/get-kol-info/v1?token=YOUR_API_KEY&kolId=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/get-kol-info/v1?token=YOUR_API_KEY&kolId=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/get-kol-info/v1?token=YOUR_API_KEY&kolId=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/get-kol-info/v1?token=YOUR_API_KEY&kolId=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": {
"abandon_sign_result": 0,
"appeal_id": "0",
"author_avatar_frame_icon": 0,
"author_type": 1,
"avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/mosaic-legacy_a09a001cbe87a5ffee25.jpeg?from=3782654143",
"avg_play": 0,
"aweme_tags": [],
"base64_qrcode": "iVBORw0KGgoAAAANSUhEUgAAAWgAAAFoAQAAAABSnlx4AAACaklEQVR4nO2azW7CQAyEZyre/5WnB/9kl3JBSsBujCpIw3cYGcsZe03hjdfPO/DQQw899NAX0g8AoF2LAkCIIgQAFKH49mIl96AfAODBjTfKYu+RX76to7s5TXq0BUEgCEKZ8uTHlNyLJiydrbD431eU3IH+48XF/f+iuhvRVr890pHdhIXaSsvyO9TR3ZW2eEcai6AoiGJcryWlju6u9AM48lcAw5LIfAq2KlNHd1fa/bfgvi/8H6Gs3lQUlTq6u9OE5HYwzKAy5JRneT3dXWkBpGW5VxJapgtUVJaCupvStEcj4bkd77AbXlLq6W5Hez/PqCKUfwCW2Fa6p788iQ7/HdYvP5AzFEv7qd+n0Fz6m/Tasrjbtf8Elyu5Bx2xpEd5HcZG15l2sJDu1rS5Esa0W+FO/PFJhTEsprshHfXEQv3ivCHrzdVK7kEf8yrLZiGel3GddeViJbeiPYOlv/7b3CI/peSf01lP0qSEE4xqEoGf+ckZ9DJwtbZ98992OxugQrrb00f3Tguv8qFJeSWvqLsjbVPBmHYfc0JBPhmc+n02LV+F2P23r0fEuXFB3R1pCoCsRm/zbz/rSWtYTHdX2p6ZPnNd598ABGa4q+nuS1PycG/+2yvK1O/T6KOf91nVs/9etgcr6e5KH7NWRNyx+u9seS5Xcg9624/10x27yCN7RvWupLs3LSkek7v/9kaevrFZTXc/2ueDsXX8tH8ixuHPzL8voMNtH/57XwKqqrstbX3Psn8SMxSNHzyVlrznebF/omOzrZzudvS+H0ts+ydxP+e0dXR3pTf//VUlQw899NBDv/P6BUugLu7JOPTyAAAAAElFTkSuQmCC",
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"category_id": "1",
"city": "",
"content_theme_labels": [
"国内旅行",
"王者游戏资讯",
"美食之旅",
"英雄出装策略",
"浪漫旅行",
"旅行特色体验",
"王者英雄玩法",
"热门游戏评测",
"王者玩法攻略",
"国服英雄挑战"
],
"core_user_id": "62427282029",
"create_time": "1543602509",
"creator_type": 0,
"e_commerce_enable": false,
"follower": 42796417,
"gender": 1,
"grade": 0,
"has_phone": true,
"id": "6629722295873044494",
"industry_list": [],
"is_cpm_project_author": false,
"is_game_author": false,
"is_online": true,
"is_plan_author": false,
"is_star": true,
"is_visible": true,
"lowest_price": 54800,
"mcn_introduction": "",
"mcn_logo": "",
"mcn_name": "",
"modify_time": "1772991558",
"nick_name": "张大仙",
"online_status": 1,
"opened_task_category": "[1, 103]",
"platform": [
1,
5
],
"platform_channel": [
1
],
"platform_source": 1,
"protocol_id": "20210524",
"province": "北京市",
"qrcode_url": "",
"sec_uid": "MS4wLjABAAAACirq2YgCDHFt4JJLwl1l5Hj4WpThkGSm8uKQJY7a2hU",
"short_id": "117908807",
"star_tags": [
{
"tag_type": 3,
"tag_value": 1
}
],
"status": 1,
"tags": "[\"\\u6e38\\u620f\"]",
"tags_author_style": "[]",
"tags_ids": "[23]",
"tags_ids_level_two": "[441]",
"tags_level_two": "[]",
"tags_relation": {
"游戏": [
"游戏集锦"
]
},
"task_status": 1,
"unique_id": "117908807"
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。