Douyin Xingtu APIs - Author Recommended Videos (V1)
prod-global
GET
/api/douyin-xingtu/gw/api/data_sp/author_rec_videos_v2/v1
Get author's high-performance recommended videos.
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.
bash
# 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/data_sp/author_rec_videos_v2/v1?token=YOUR_API_KEY&oAuthorId=VALUE"text
I want to use the "Author Recommended Videos (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/author_rec_videos_v2/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/author-recommended-videos-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/data_sp/author_rec_videos_v2/v1?token=YOUR_API_KEY&oAuthorId=VALUE"
response = requests.get(url)
print(response.json())js
// 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/data_sp/author_rec_videos_v2/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/data_sp/author_rec_videos_v2/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/data_sp/author_rec_videos_v2/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/data_sp/author_rec_videos_v2/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;Responses
json
{
"code": 0,
"data": {
"base_resp": {
"status_code": 0,
"status_message": ""
},
"masterpiece_videos": [
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1758829144,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7553989899192519974",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 8543418,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
},
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1764857152,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7579880027882799283",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 7071310,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
}
],
"newest_videos": [
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1771622436,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7608935920095612211",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 3020822,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
},
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1771203143,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7607135237205921062",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 3387627,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
}
],
"order_hot_videos": [],
"personal_hot_videos": [
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1761164868,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7564021773411372327",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 19764567,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
},
{
"acu": 0,
"avg_watch": 0,
"barrage": 0,
"biz_id": "0",
"comment": 0,
"core_user_id": "0",
"create_time": 1762544325,
"create_timestamp": 0,
"duration": 0,
"duration_min": 0,
"fans_club": 0,
"favorite": "0",
"finish_time": 0,
"head_image_uri": "",
"head_image_uris": [],
"head_image_url_signed": "",
"height": "0",
"impression": 0,
"industry": "",
"interact_rate": 0,
"is_hot": false,
"is_playlet": 0,
"item_animated_cover": "",
"item_cover": "",
"item_date": "",
"item_id": "7569946527527885642",
"item_title": "",
"like": 0,
"live_status": 0,
"max_watch": 0,
"media_type": "0",
"original_status": 0,
"play": 9971415,
"play_over_5min": 0,
"read_cnt": "0",
"repin": 0,
"send_gift": 0,
"send_prop": 0,
"send_red_packet": 0,
"share": 0,
"status": 0,
"title": "",
"url": "",
"video_id": "",
"width": "0"
}
]
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.