Skip to content

抖音指数创作指南 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

从抖音创作者中心创作指南中获取选定的排名、内容生产报告、内容消费报告或发布日历。使用内容垂类和已发布的报告日期来研究热门关键词、话题、视频和受众趋势。

使用提示 ​

使用说明

每次请求仅选择一个 dataType。使用 CONTENT_DATES 或 VIDEO_DATES 在单独请求中查询已发布日期。每个排名或报告请求都需要明确的 endDate。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-此API服务的鉴权令牌。
analysisTypequerystring是-创作指南分析标签页。


可用值:

- CREATIVITY:创意洞察与排名

- PRODUCTION:内容生产分析

- CONSUMPTION:内容消费分析
dataTypequerystring是-所选标签页中的一个数据集。对于创意洞察排名,请选择 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 搭配使用
verticalquerystring否-内容垂类。排名和报告必需。发布日历可省略。


可用值:

- 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:汽车与汽车行业
periodquerystring否-排名可选择 ONE_DAY、THREE_DAYS 或 WEEK。画像和视频时长报告可选择 WEEK 或 MONTH。趋势报告和发布日历可省略。


可用值:

- ONE_DAY:一个已发布日。仅用于排名

- THREE_DAYS:截至指定发布日的三天。仅用于排名

- WEEK:以周日结束的一个报告周

- MONTH:一个自然月。仅用于画像和视频时长报告
startDatequerystring否-中国时间(UTC+8)的起始日期(含),格式为 YYYY-MM-DD。发布趋势、供需趋势和互动趋势必需。其他数据类型可省略。
endDatequerystring否-中国时间(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

字段类型说明
daystring内容报告以及关键词或话题排名的最新发布日,格式为 YYYYMMDD。
weekstring内容报告以及关键词或话题排名的最新发布周结束日期,格式为 YYYYMMDD。
monthstring内容报告的最新发布月结束日期,格式为 YYYYMMDD。
earliest_weekstring最早可用的内容报告周结束日期,格式为 YYYYMMDD。
latest_daystring热门视频排名的最新发布日,格式为 YYYYMMDD。
start_weekstring最早可用的视频排名周结束日期,格式为 YYYYMMDD。
end_weekstring最新可用视频排名周的结束日期,格式为YYYYMMDD。
热门关键词7 个字段

data

字段类型说明
keyword_listarray所选垂直领域和时间段的热门关键词。
keyword_list[]object一个热门关键词。
keyword_list[].keywordstring关键词文本。
keyword_list[].cntstring与该关键词关联的视频数量,以字符串表示。
keyword_list[].is_hotboolean抖音返回的热门关键词指标。
keyword_list[].indexstring综合指数,以字符串表示。
keyword_list[].search_indexstring搜索指数,以字符串表示。
热门话题9 个字段

data

字段类型说明
topic_listarray所选垂直领域和时间段的热门话题。
topic_list[]object一个热门话题。
topic_list[].idstring抖音话题标识符。
topic_list[].namestring话题名称。
topic_list[].indexstring话题指数,以字符串表示。
topic_list[].item_cntstring投稿数量,以字符串表示。
topic_list[].vvstring播放量,以字符串表示。
topic_list[].digg_cntstring点赞数,以字符串表示。
topic_list[].item_listarray相关条目(如有)。
热门视频18 个字段

data

字段类型说明
video_infosarray所选垂直领域和时间段的热门视频。
video_infos[]object榜单中的一个视频。
video_infos[].item_idstring抖音视频标识符。
video_infos[].author_fansstring创作者粉丝数,以字符串表示。
video_infos[].indexstring视频指数,以字符串表示。
video_infos[].like_cntstring点赞数,以字符串表示。
video_infos[].seqstring在排名中的位置,以字符串表示。
video_infos[].video_titlestring视频标题。
video_infos[].authorstring达人展示名称。
video_infos[].comment_cntstring评论数,以字符串表示。
video_infos[].forward_cntstring分享数,以字符串表示。
video_infos[].thumbnailstring视频缩略图地址。
video_infos[].avatar_urlstring创作者头像 URL。
video_infos[].statusstring视频状态值。
video_infos[].play_cntstring播放量,以字符串表示。
video_infos[].author_idstring抖音创作者标识符。
page_respobject排名结果数量。
page_resp.total_numstring视频排名报告的总数,以字符串表示。
内容生产12 个字段

data

字段类型说明
author_listarray内容创作者的趋势序列。
author_list[]object趋势中的一天。
author_list[].datestring报告日期,格式为YYYYMMDD。
author_list[].ratenumber该趋势点的值。
item_listarray已发布内容的趋势序列。
item_list[]object趋势中的一天。
item_list[].datestring报告日期,格式为YYYYMMDD。
item_list[].ratenumber该趋势点的值。
dataarray所选垂直领域和周期的创作者画像分布。
data[]object受众或创作者画像中的一个属性。
data[].name_enstring画像属性的标识符。
data[].label_listarray该属性的分布条目。
内容消费20 个字段

data

字段类型说明
supply_trendarray内容供给的趋势序列。
supply_trend[]object趋势中的一天。
supply_trend[].datestring报告日期,格式为YYYYMMDD。
supply_trend[].ratenumber该趋势点的值。
consume_trendobject内容消费趋势及关联热门条目。
consume_trend.rate_listarray所选时间段返回的时间序列。
consume_trend.rate_list[]object一个报告的观测值。
consume_trend.top_listarray随趋势返回的热门条目。
interact_trendobject内容互动趋势及关联热门条目。
interact_trend.rate_listarray所选时间段返回的时间序列。
interact_trend.rate_list[]object一个报告的观测值。
interact_trend.top_listarray随趋势返回的热门条目。
play_dataarray视频观看的受众画像分布。
play_data[]object受众或创作者画像中的一个属性。
play_data[].name_enstring画像属性的标识符。
play_data[].label_listarray该属性的分布条目。
interaction_dataarray视频互动的受众画像分布。
interaction_data[]object受众或创作者画像中的一个属性。
interaction_data[].name_enstring画像属性的标识符。
interaction_data[].label_listarray该属性的分布条目。
视频时长分布7 个字段

data

字段类型说明
rate_listarray按视频时长分组的统计数据。
rate_list[]object一个视频时长分组。
rate_list[].durationstring视频时长分组的标签。
rate_list[].content_ratenumber该时长分组中的内容占比。
rate_list[].interaction_ratenumber该时长分组中视频的互动率。
rate_list[].finish_ratenumber该时长分组中视频的完播率。
rate_list[].top_items_listarray该时长的热门视频分组(如有)。

响应示例 ​

正在加载响应示例…