抖音巨量星图创作者搜索 API (V1)
GET
/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
获取抖音巨量星图创作者搜索数据，包括筛选条件、返回资料和受众信息，用于发现、比较和建立候选名单。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用户鉴权令牌。 |
keyword | query | string | 否 | `` | 搜索关键词。 |
page | query | integer | 否 | 1 | 用于分页的页码。 |
searchType | query | string | 否 | NICKNAME | 搜索条件类型。 可用值： - NICKNAME: 按昵称- CONTENT: 按内容 |
followerRange | query | string | 否 | - | 粉丝数量范围（例如：10-100）。 |
kolPriceType | query | string | 否 | - | KOL 价格类型。 可用值： - 视频1_20s: 视频 1-20 秒- 视频21_60s: 视频 21-60 秒- 视频60s以上: 视频 > 60 秒- 定制短剧单集: 定制短剧单集- 千次自然播放量: 千次自然播放量- 短直种草视频: 短直种草视频- 短直预热视频: 短直预热视频- 短直明星种草: 短直明星种草- 短直明星预热: 短直明星预热- 明星视频: 明星视频- 合集视频: 合集视频- 抖音短视频共创_主投稿达人: 抖音短视频共创 - 主投稿达人- 抖音短视频共创_参与达人: 抖音短视频共创 - 参与达人 |
kolPriceRange | query | string | 否 | - | KOL 价格范围（例如：10000-50000）。 |
contentTag | query | string | 否 | - | 内容标签筛选。 |
代码示例
💡 环境说明
默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
bash
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"text
我想使用 Just One API 提供的“创作者搜索 (V1)”接口。
接入地址: 默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
接口路径: /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
接口地址: BASE_URL + /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-creator-marketplace-xingtu/creator-search-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- keyword (query): 搜索关键词。
- page (query): 用于分页的页码。
- searchType (query): 搜索条件类型。
可用值：
- `NICKNAME`: 按昵称
- `CONTENT`: 按内容
- followerRange (query): 粉丝数量范围（例如：10-100）。
- kolPriceType (query): KOL 价格类型。
可用值：
- `视频1_20s`: 视频 1-20 秒
- `视频21_60s`: 视频 21-60 秒
- `视频60s以上`: 视频 > 60 秒
- `定制短剧单集`: 定制短剧单集
- `千次自然播放量`: 千次自然播放量
- `短直种草视频`: 短直种草视频
- `短直预热视频`: 短直预热视频
- `短直明星种草`: 短直明星种草
- `短直明星预热`: 短直明星预热
- `明星视频`: 明星视频
- `合集视频`: 合集视频
- `抖音短视频共创_主投稿达人`: 抖音短视频共创 - 主投稿达人
- `抖音短视频共创_参与达人`: 抖音短视频共创 - 参与达人
- kolPriceRange (query): KOL 价格范围（例如：10000-50000）。
- contentTag (query): 内容标签筛选。
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 大陆用户可改为 "http://47.117.133.51:30015"
url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())js
const BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
const url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";
const response = await fetch(url, {
method: "GET"
});
const data = await response.json();
console.log(data);java
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 {
final String BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
final String url = BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
package main
import (
"fmt"
"io"
"net/http"
)
const BASE_URL = "https://api.justoneapi.com" // 大陆用户可改为 "http://47.117.133.51:30015"
func main() {
client := &http.Client{}
url := BASE_URL + "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
<?php
$BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果示例
正在加载最新成功示例…