抖音星图 API - KOL 关键词搜索 (V1)

prod-global

GET

/api/douyin-xingtu/search-kol-simple/v1

基于关键词的简单KOL搜索。

请求参数

参数名	位置	类型	必填	说明
`token`	query	`string`	是	用户鉴权令牌。
`keyword`	query	`string`	是	搜索关键词。
`platformSource`	query	`string`	是	平台来源。可用值： - `_1`: 抖音 - `_2`: 头条 - `_3`: 西瓜
`page`	query	`integer`	是	页码。
`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/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0"

text

我想使用 Just One API 提供的“KOL 关键词搜索 (V1)”接口。
接口地址: https://api.justoneapi.com/api/douyin-xingtu/search-kol-simple/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/kol-keyword-search-v1-zh.json

请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- keyword (query): 搜索关键词。 (必填)
- platformSource (query): 平台来源。

可用值：
- `_1`: 抖音
- `_2`: 头条
- `_3`: 西瓜 (必填)
- page (query): 页码。 (必填)
- 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/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0"
response = requests.get(url)
print(response.json())

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin-xingtu/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0", {
  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/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

// 提示: 中国大陆地区建议将 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/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0"
	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/search-kol-simple/v1?token=YOUR_API_KEY&keyword=VALUE&platformSource=VALUE&page=0");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI 定义 (JSON)]

响应结果

json

{
  "code": 0,
  "data": {
    "authors": [
      {
        "attribute_datas": {
          "assign_cpm_suggest_price": "97",
          "author_avatar_frame_icon": "0",
          "author_ecom_level": "L1",
          "author_level_game": "Lv1",
          "author_level_other": "Lv1",
          "author_status": "1",
          "author_thin_mid_word_association_index": "{\"清爽\":0.001,\"美白\":0,\"胶原成分\":0,\"防晒\":0}",
          "author_type": "3",
          "avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_b599131429f4663d0aefe659daad0...",
          "brand_boost_vv": "52097",
          "city": "杭州市",
          "content_theme_labels_180d": "[\"个人成长\",\"保暖穿搭\",\"零食测评\",\"消费体验\",\"羽绒服穿搭\",\"口红测评\",\"健康养生\",\"秋冬穿搭\",\"护发技巧\",\"体重管理\"]",
          "core_user_id": "93237932151",
          "e_commerce_enable": "1",
          "ecom_avg_order_value_30d_range": "50-200",
          "ecom_gmv_30d_range": "1k-3w",
          "ecom_gpm_30d_range": "<=80",
          "ecom_score": "82",
          "ecom_video_ctr_30d_range": "8%-10%",
          "ecom_video_mid_click_pv_30d_range": "500以下",
          "ecom_video_product_num_30d": "4",
          "enroll_task_price_list": "[15000]",
          "expected_cpa3_level": "4",
          "expected_natural_play_num": "11360",
          "expected_play_num": "15219",
          "fans_increment_rate_within_15d": "-0.0025303994312070445",
          "fans_increment_within_15d": "-694",
          "fans_increment_within_30d": "-1533",
          "follower": "273517",
          "game_type": "",
          "gender": "2",
          "grade": "0",
          "id": "6978702114235088932",
          "interact_rate_within_30d": "0.0286",
          "interaction_median_30d": "256",
          "is_ad_star_cur_high_quality_author": "0",
          "is_black_horse_author": "false",
          "is_cocreate_author": "false",
          "is_cpm_project_author": "0",
          "is_excellenct_author": "0",
          "is_short_drama": "0",
          "last_10_items": "[{\"comment_cnt\":\"31\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1772459830\",\"item_id\":\"761265693...",
          "link_convert_index": "77.48",
          "link_convert_index_by_industry": "77.48",
          "link_i_cnt_by_industry": "101664",
          "link_k_cnt_by_industry": "131",
          "link_l_cnt_by_industry": "303648",
          "link_link_cnt_by_industry": "497272",
          "link_n_cnt_by_industry": "91829",
          "link_recommend_index_by_industry": "60.63",
          "link_shopping_index": "60.63",
          "link_spread_index": "63.3",
          "link_spread_index_by_industry": "63.3",
          "link_star_index": "70.24",
          "link_star_index_by_industry": "70.24",
          "link_user_type_by_industry": "2",
          "local_lower_threshold_author": "false",
          "nick_name": "中年美妆博母杨光",
          "pic_expected_play_num": "0",
          "play_over_rate_within_30d": "0.0641",
          "price_1_20": "24000",
          "price_20_60": "27000",
          "price_60": "28000",
          "promotion_prospective_1_20_cpm": "1764.19",
          "promotion_prospective_20_60_cpm": "1984.71",
          "promotion_prospective_60_cpm": "2058.22",
          "promotion_prospective_vv": "13604",
          "prospective_1_20_cpm": "1576.9761",
          "prospective_20_60_cpm": "1774.0982",
          "prospective_60_cpm": "1839.8055",
          "province": "浙江省",
          "search_after_view_index_by_industry": "87.06",
          "sn_expected_play_num": "15219",
          "sn_interact_rate_within_30d": "0.0286",
          "sn_play_over_rate_within_30d": "0.0641",
          "sn_prospective_1_20_cpe": "78.6885",
          "sn_prospective_1_20_cpm": "1576.9761",
          "sn_prospective_20_60_cpe": "88.5246",
          "sn_prospective_20_60_cpm": "1774.0982",
          "sn_prospective_60_cpe": "91.8033",
          "sn_prospective_60_cpm": "1839.8055",
          "star_ecom_video_num_30d": "0",
          "star_excellent_author": "0",
          "star_index": "81.2509603142163",
          "star_qianchuan_high_potential": "0",
          "star_whispers_author": "0",
          "tags_relation": "{\"时尚\":[\"穿搭\"]}",
          "video_brand_boost": "true",
          "video_brand_boost_vv": "52097",
          "vv_median_30d": "13379"
        },
        "extra_data": {
          "content_query_from_word": "",
          "content_query_score": 0,
          "debug_info": "",
          "demander_behavior": {
            "added_author_list": false,
            "cooperated": false,
            "viewd_author_page": false
          },
          "recall_from": [
            "1_0"
          ],
          "recall_return_infos": {},
          "recommend_types": []
        },
        "items": [
          {
            "item_id": "7580711922930502073",
            "video_tag": 3,
            "vv": 3224450
          }
        ],
        "star_id": "6978702114235088932",
        "task_infos": [
          {
            "online_status": 1,
            "platform_source": 1,
            "price_infos": [
              {
                "end_time": "2145916800",
                "platform_source": 1,
                "price": 15000,
                "price_extra_info": {},
                "start_time": "1682870400",
                "task_category": 1,
                "video_type": 73,
                "video_type_status": 1
              }
            ],
            "task_category": 1,
            "task_status": 1
          }
        ]
      }
    ],
    "base_resp": {
      "status_code": 0,
      "status_message": ""
    },
    "extra_data": {
      "is_cpm_project_search": false,
      "search_author_count": 0,
      "search_item_count": 0,
      "search_session_id": "7615253138564218918"
    },
    "pagination": {
      "has_more": true,
      "limit": 20,
      "page": 1,
      "total_count": 4385
    }
  }
}

💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。

抖音星图 API - KOL 关键词搜索 (V1) ​

请求参数 ​

代码示例 ​

响应结果 ​

抖音星图 API - KOL 关键词搜索 (V1)

请求参数

代码示例

响应结果