抖音指数创作指南 API (V1)
GET
接口健康状态
24h 健康值
24h 平均耗时
最近检查时间
健康 可用 少量可用 基本不可用 暂无数据
健康
正在加载健康状态…
24 小时趋势
30 天趋势
从抖音创作者中心创作指南中获取选定的排名、内容生产报告、内容消费报告或发布日历。使用内容垂类和已发布的报告日期来研究热门关键词、话题、视频和受众趋势。
使用提示
使用说明
每次请求仅选择一个 dataType。使用 CONTENT_DATES 或 VIDEO_DATES 在单独请求中查询已发布日期。每个排名或报告请求都需要明确的 endDate。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 此API服务的鉴权令牌。 |
analysisType | query | string | 是 | - | 创作指南分析标签页。 可用值: - CREATIVITY:创意洞察与排名- PRODUCTION:内容生产分析- CONSUMPTION:内容消费分析 |
dataType | query | string | 是 | - | 所选标签页中的一个数据集。对于创意洞察排名,请选择 KEYWORDS、TOPICS 或 VIDEOS。 可用值: - CONTENT_DATES:关键词和话题排名以及生产和消费报告的发布日历- VIDEO_DATES:热门视频排名的发布日历。与 CREATIVITY 搭配使用- KEYWORDS:热门关键词。与 CREATIVITY 搭配使用- TOPICS:热门话题。与 CREATIVITY 搭配使用- VIDEOS:热门视频。与 CREATIVITY 搭配使用- PUBLISH_TREND:内容发布趋势。与 PRODUCTION 搭配使用- AUTHOR_PORTRAIT:创作者画像分布。与 PRODUCTION 搭配使用- VIDEO_DURATION:按视频时长划分的内容分享率、互动率和完播率。与 PRODUCTION 或 CONSUMPTION 搭配使用- CONSUME_TREND:内容供需趋势。与 CONSUMPTION 搭配使用- INTERACT_TREND:内容互动趋势。与 CONSUMPTION 搭配使用- CONSUMER_PORTRAIT:观看和互动受众分布。与 CONSUMPTION 搭配使用 |
vertical | query | string | 否 | - | 内容垂类。排名和报告必需。发布日历可省略。 可用值: - DRAMA:虚构故事和戏剧- CELEBRITIES:名人- MUSIC:音乐- ANIME_COMICS:动漫、漫画及相关粉丝文化- GAMING:游戏- CURRENT_AFFAIRS:社会与时事- DANCE:舞蹈- RURAL_LIFE:农业、农村和乡村生活- TECHNOLOGY:科学与技术- FINANCE:商业与财经- PARENTING:母婴与育儿- LIFESTYLE_HOME:生活方式与家居- HEALTH:医疗与健康- RELATIONSHIPS:情感与心理健康- CULTURE:文化- CAREERS:职业与职场- EDUCATION:教育与校园生活- PHOTOGRAPHY:摄影与摄像- FOOD:美食与烹饪- TRAVEL:旅行- FASHION:时尚- SPORTS:体育- ENTERTAINMENT:休闲娱乐- AUTOMOTIVE:汽车与汽车行业 |
period | query | string | 否 | - | 排名可选择 ONE_DAY、THREE_DAYS 或 WEEK。画像和视频时长报告可选择 WEEK 或 MONTH。趋势报告和发布日历可省略。 可用值: - ONE_DAY:一个已发布日。仅用于排名- THREE_DAYS:截至指定发布日的三天。仅用于排名- WEEK:以周日结束的一个报告周- MONTH:一个自然月。仅用于画像和视频时长报告 |
startDate | query | string | 否 | - | 中国时间(UTC+8)的起始日期(含),格式为 YYYY-MM-DD。发布趋势、供需趋势和互动趋势必需。其他数据类型可省略。 |
endDate | query | string | 否 | - | 中国时间(UTC+8)的结束日期(含),格式为 YYYY-MM-DD。排名和报告必需。对于 WEEK 使用已发布的周日,对于 MONTH 使用已发布的月末。发布日历可省略。 |
代码示例
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES'text
我想使用 JustOneAPI 提供的“创作指南 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES
接口地址: BASE_URL + /api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-index/creation-guide-v1-zh.json
请求参数说明:
- token (query): 此API服务的鉴权令牌。 (必填)
- analysisType (query): 创作指南分析标签页。
可用值:
- `CREATIVITY`:创意洞察与排名
- `PRODUCTION`:内容生产分析
- `CONSUMPTION`:内容消费分析 (必填)
- dataType (query): 所选标签页中的一个数据集。对于创意洞察排名,请选择 KEYWORDS、TOPICS 或 VIDEOS。
可用值:
- `CONTENT_DATES`:关键词和话题排名以及生产和消费报告的发布日历
- `VIDEO_DATES`:热门视频排名的发布日历。与 CREATIVITY 搭配使用
- `KEYWORDS`:热门关键词。与 CREATIVITY 搭配使用
- `TOPICS`:热门话题。与 CREATIVITY 搭配使用
- `VIDEOS`:热门视频。与 CREATIVITY 搭配使用
- `PUBLISH_TREND`:内容发布趋势。与 PRODUCTION 搭配使用
- `AUTHOR_PORTRAIT`:创作者画像分布。与 PRODUCTION 搭配使用
- `VIDEO_DURATION`:按视频时长划分的内容分享率、互动率和完播率。与 PRODUCTION 或 CONSUMPTION 搭配使用
- `CONSUME_TREND`:内容供需趋势。与 CONSUMPTION 搭配使用
- `INTERACT_TREND`:内容互动趋势。与 CONSUMPTION 搭配使用
- `CONSUMER_PORTRAIT`:观看和互动受众分布。与 CONSUMPTION 搭配使用 (必填)
- vertical (query): 内容垂类。排名和报告必需。发布日历可省略。
可用值:
- `DRAMA`:虚构故事和戏剧
- `CELEBRITIES`:名人
- `MUSIC`:音乐
- `ANIME_COMICS`:动漫、漫画及相关粉丝文化
- `GAMING`:游戏
- `CURRENT_AFFAIRS`:社会与时事
- `DANCE`:舞蹈
- `RURAL_LIFE`:农业、农村和乡村生活
- `TECHNOLOGY`:科学与技术
- `FINANCE`:商业与财经
- `PARENTING`:母婴与育儿
- `LIFESTYLE_HOME`:生活方式与家居
- `HEALTH`:医疗与健康
- `RELATIONSHIPS`:情感与心理健康
- `CULTURE`:文化
- `CAREERS`:职业与职场
- `EDUCATION`:教育与校园生活
- `PHOTOGRAPHY`:摄影与摄像
- `FOOD`:美食与烹饪
- `TRAVEL`:旅行
- `FASHION`:时尚
- `SPORTS`:体育
- `ENTERTAINMENT`:休闲娱乐
- `AUTOMOTIVE`:汽车与汽车行业
- period (query): 排名可选择 ONE_DAY、THREE_DAYS 或 WEEK。画像和视频时长报告可选择 WEEK 或 MONTH。趋势报告和发布日历可省略。
可用值:
- `ONE_DAY`:一个已发布日。仅用于排名
- `THREE_DAYS`:截至指定发布日的三天。仅用于排名
- `WEEK`:以周日结束的一个报告周
- `MONTH`:一个自然月。仅用于画像和视频时长报告
- startDate (query): 中国时间(UTC+8)的起始日期(含),格式为 YYYY-MM-DD。发布趋势、供需趋势和互动趋势必需。其他数据类型可省略。
- endDate (query): 中国时间(UTC+8)的结束日期(含),格式为 YYYY-MM-DD。排名和报告必需。对于 WEEK 使用已发布的周日,对于 MONTH 使用已发布的月末。发布日历可省略。
返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
final String url = BASE_URL + "/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/douyin-index/get-creation-guide/v1?token=YOUR_API_KEY&analysisType=CREATIVITY&dataType=CONTENT_DATES';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}返回字段
业务成功时(code = 0)的主要返回字段。
可用统计日期7 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
day | string | 内容报告以及关键词或话题排名的最新发布日,格式为 YYYYMMDD。 |
week | string | 内容报告以及关键词或话题排名的最新发布周结束日期,格式为 YYYYMMDD。 |
month | string | 内容报告的最新发布月结束日期,格式为 YYYYMMDD。 |
earliest_week | string | 最早可用的内容报告周结束日期,格式为 YYYYMMDD。 |
latest_day | string | 热门视频排名的最新发布日,格式为 YYYYMMDD。 |
start_week | string | 最早可用的视频排名周结束日期,格式为 YYYYMMDD。 |
end_week | string | 最新可用视频排名周的结束日期,格式为YYYYMMDD。 |
热门关键词7 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
keyword_list | array | 所选垂直领域和时间段的热门关键词。 |
keyword_list[] | object | 一个热门关键词。 |
keyword_list[].keyword | string | 关键词文本。 |
keyword_list[].cnt | string | 与该关键词关联的视频数量,以字符串表示。 |
keyword_list[].is_hot | boolean | 抖音返回的热门关键词指标。 |
keyword_list[].index | string | 综合指数,以字符串表示。 |
keyword_list[].search_index | string | 搜索指数,以字符串表示。 |
热门话题9 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
topic_list | array | 所选垂直领域和时间段的热门话题。 |
topic_list[] | object | 一个热门话题。 |
topic_list[].id | string | 抖音话题标识符。 |
topic_list[].name | string | 话题名称。 |
topic_list[].index | string | 话题指数,以字符串表示。 |
topic_list[].item_cnt | string | 投稿数量,以字符串表示。 |
topic_list[].vv | string | 播放量,以字符串表示。 |
topic_list[].digg_cnt | string | 点赞数,以字符串表示。 |
topic_list[].item_list | array | 相关条目(如有)。 |
热门视频18 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
video_infos | array | 所选垂直领域和时间段的热门视频。 |
video_infos[] | object | 榜单中的一个视频。 |
video_infos[].item_id | string | 抖音视频标识符。 |
video_infos[].author_fans | string | 创作者粉丝数,以字符串表示。 |
video_infos[].index | string | 视频指数,以字符串表示。 |
video_infos[].like_cnt | string | 点赞数,以字符串表示。 |
video_infos[].seq | string | 在排名中的位置,以字符串表示。 |
video_infos[].video_title | string | 视频标题。 |
video_infos[].author | string | 达人展示名称。 |
video_infos[].comment_cnt | string | 评论数,以字符串表示。 |
video_infos[].forward_cnt | string | 分享数,以字符串表示。 |
video_infos[].thumbnail | string | 视频缩略图地址。 |
video_infos[].avatar_url | string | 创作者头像 URL。 |
video_infos[].status | string | 视频状态值。 |
video_infos[].play_cnt | string | 播放量,以字符串表示。 |
video_infos[].author_id | string | 抖音创作者标识符。 |
page_resp | object | 排名结果数量。 |
page_resp.total_num | string | 视频排名报告的总数,以字符串表示。 |
内容生产12 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
author_list | array | 内容创作者的趋势序列。 |
author_list[] | object | 趋势中的一天。 |
author_list[].date | string | 报告日期,格式为YYYYMMDD。 |
author_list[].rate | number | 该趋势点的值。 |
item_list | array | 已发布内容的趋势序列。 |
item_list[] | object | 趋势中的一天。 |
item_list[].date | string | 报告日期,格式为YYYYMMDD。 |
item_list[].rate | number | 该趋势点的值。 |
data | array | 所选垂直领域和周期的创作者画像分布。 |
data[] | object | 受众或创作者画像中的一个属性。 |
data[].name_en | string | 画像属性的标识符。 |
data[].label_list | array | 该属性的分布条目。 |
内容消费20 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
supply_trend | array | 内容供给的趋势序列。 |
supply_trend[] | object | 趋势中的一天。 |
supply_trend[].date | string | 报告日期,格式为YYYYMMDD。 |
supply_trend[].rate | number | 该趋势点的值。 |
consume_trend | object | 内容消费趋势及关联热门条目。 |
consume_trend.rate_list | array | 所选时间段返回的时间序列。 |
consume_trend.rate_list[] | object | 一个报告的观测值。 |
consume_trend.top_list | array | 随趋势返回的热门条目。 |
interact_trend | object | 内容互动趋势及关联热门条目。 |
interact_trend.rate_list | array | 所选时间段返回的时间序列。 |
interact_trend.rate_list[] | object | 一个报告的观测值。 |
interact_trend.top_list | array | 随趋势返回的热门条目。 |
play_data | array | 视频观看的受众画像分布。 |
play_data[] | object | 受众或创作者画像中的一个属性。 |
play_data[].name_en | string | 画像属性的标识符。 |
play_data[].label_list | array | 该属性的分布条目。 |
interaction_data | array | 视频互动的受众画像分布。 |
interaction_data[] | object | 受众或创作者画像中的一个属性。 |
interaction_data[].name_en | string | 画像属性的标识符。 |
interaction_data[].label_list | array | 该属性的分布条目。 |
视频时长分布7 个字段
data
| 字段 | 类型 | 说明 |
|---|---|---|
rate_list | array | 按视频时长分组的统计数据。 |
rate_list[] | object | 一个视频时长分组。 |
rate_list[].duration | string | 视频时长分组的标签。 |
rate_list[].content_rate | number | 该时长分组中的内容占比。 |
rate_list[].interaction_rate | number | 该时长分组中视频的互动率。 |
rate_list[].finish_rate | number | 该时长分组中视频的完播率。 |
rate_list[].top_items_list | array | 该时长的热门视频分组(如有)。 |
响应示例
正在加载响应示例…