Douyin Xingtu APIs - Author Base Info (V1)

prod-global

GET

/api/douyin-xingtu/gw/api/author/get_author_base_info/v1

Retrieve basic information for a specific author.

Parameters

Name	In	Type	Required	Description
token	query	string	Yes	User authentication token.
oAuthorId	query	string	Yes	Author's unique ID.
platform	query	string	No	Platform type. Available Values: - SHORT_VIDEO: Short video - LIVE_STREAMING: Live streaming - PICTURE_TEXT: Picture and text - SHORT_DRAMA: Short drama

Code Samples

💡 Environment Note

Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.

🐚 cURL

# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/gw/api/author/get_author_base_info/v1?token=YOUR_API_KEY&oAuthorId=VALUE"

🤖 AI Prompt

I want to use the "Author Base Info (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin-xingtu/gw/api/author/get_author_base_info/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/author-base-info-v1-en.json

Parameters:
- token (query): User authentication token. (Required)
- oAuthorId (query): Author's unique ID. (Required)
- platform (query): Platform type.

Available Values:
- `SHORT_VIDEO`: Short video
- `LIVE_STREAMING`: Live streaming
- `PICTURE_TEXT`: Picture and text
- `SHORT_DRAMA`: Short drama

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

# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import requests

url = "https://api.justoneapi.com/api/douyin-xingtu/gw/api/author/get_author_base_info/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
response = requests.get(url)
print(response.json())

🌐 JavaScript

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin-xingtu/gw/api/author/get_author_base_info/v1?token=YOUR_API_KEY&oAuthorId=VALUE", {
  method: "GET"
});
const data = await response.json();
console.log(data);

☕ Java

// Tip: For Mainland China, replace https://api.justoneapi.com with 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/author/get_author_base_info/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

// Tip: For Mainland China, replace https://api.justoneapi.com with 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/author/get_author_base_info/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

// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douyin-xingtu/gw/api/author/get_author_base_info/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;

[OpenAPI Definition (JSON)]

Responses

{
  "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"
  }
}

💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.