Douyin Creator Marketplace (Xingtu) Creator Search API (V1)
GET
/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | User authentication token. |
keyword | query | string | No | `` | Search keyword. |
page | query | integer | No | 1 | Page number for pagination. |
searchType | query | string | No | NICKNAME | Search criteria type. Available Values: - NICKNAME: By Nickname- CONTENT: By Content |
followerRange | query | string | No | - | Follower range (e.g., 10-100). |
kolPriceType | query | string | No | - | KOL price type. Available Values: - 视频1_20s: Video 1-20s- 视频21_60s: Video 21-60s- 视频60s以上: Video > 60s- 定制短剧单集: Mini-drama episode- 千次自然播放量: CPM naturally- 短直种草视频: Short-live seeding video- 短直预热视频: Short-live warm-up video- 短直明星种草: Celebrity short-live seeding- 短直明星预热: Celebrity short-live warm-up- 明星视频: Celebrity video- 合集视频: Collection video- 抖音短视频共创_主投稿达人: Douyin short video co-creation - main creator- 抖音短视频共创_参与达人: Douyin short video co-creation - participant |
kolPriceRange | query | string | No | - | KOL price range (e.g., 10000-50000). |
contentTag | query | string | No | - | Content tag filter. |
Code Samples
💡 Environment Note
Use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.
bash
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY"text
I want to use the "Creator Search (V1)" API from Just One API.
Base URL: use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.
API Path: /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
API Endpoint: BASE_URL + /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1?token=YOUR_API_KEY
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-creator-marketplace-xingtu/creator-search-v1-en.json
Parameters:
- token (query): User authentication token. (Required)
- keyword (query): Search keyword.
- page (query): Page number for pagination.
- searchType (query): Search criteria type.
Available Values:
- `NICKNAME`: By Nickname
- `CONTENT`: By Content
- followerRange (query): Follower range (e.g., 10-100).
- kolPriceType (query): KOL price type.
Available Values:
- `视频1_20s`: Video 1-20s
- `视频21_60s`: Video 21-60s
- `视频60s以上`: Video > 60s
- `定制短剧单集`: Mini-drama episode
- `千次自然播放量`: CPM naturally
- `短直种草视频`: Short-live seeding video
- `短直预热视频`: Short-live warm-up video
- `短直明星种草`: Celebrity short-live seeding
- `短直明星预热`: Celebrity short-live warm-up
- `明星视频`: Celebrity video
- `合集视频`: Collection video
- `抖音短视频共创_主投稿达人`: Douyin short video co-creation - main creator
- `抖音短视频共创_参与达人`: Douyin short video co-creation - participant
- kolPriceRange (query): KOL price range (e.g., 10000-50000).
- contentTag (query): Content tag filter.
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
import requests
BASE_URL = "https://api.justoneapi.com" # Mainland China: "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"; // Mainland China: "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"; // Mainland China: "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" // Mainland China: "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"; // Mainland China: "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;Response Example
Loading the latest successful example...