Douyin Creator Marketplace (Xingtu) Spread Metrics API

核心功能为调用抖音星图指定API，获取KOL的受众、内容表现、商业指标等传播数据，用于快速评估KOL价值。典型场景包括品牌方筛选投放KOL、运营分析KOL数据表现。输入需必填参数kolId，可选时间范围、内容类型等，需JUST_ONE_API_TOKEN认证。输出先返回指标摘要，再返回原始JSON数据；若出错则返回错误详情。

justoneapi

热度 33.01

最近更新 2026-05-11 17:45:50

分类：开发依赖：代码执行 / 第三方 API应用场景：API 集成 / 数据处理 / 市场分析

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add justoneapi-douyin-xingtu-get-kol-spread-info

Metadata

name: Douyin Creator Marketplace (Xingtu) Spread Metrics API
description: Call GET /api/douyin-xingtu/get-kol-spread-info/v1 for Douyin Creator Marketplace (Xingtu) Spread Metrics through JustOneAPI with kolId.
author: JustOneAPI
homepage: https://api.justoneapi.com
metadata: {"openclaw":{"homepage":"https://api.justoneapi.com","primaryEnv":"JUST_ONE_API_TOKEN","requires":{"bins":["node"],"env":["JUST_ONE_API_TOKEN"]},"skillKey":"justoneapi_douyin_xingtu_get_kol_spread_info"}}

Douyin Creator Marketplace (Xingtu) Spread Metrics

Use this focused JustOneAPI skill for spread Metrics in Douyin Creator Marketplace (Xingtu). It targets GET /api/douyin-xingtu/get-kol-spread-info/v1. Required non-token inputs are kolId. OpenAPI describes it as: Get Douyin Creator Marketplace (Xingtu) spread metrics data, including audience, content performance, and commercial indicators, for quick evaluation.

Endpoint Scope

Platform key: douyin-xingtu
Endpoint key: get-kol-spread-info
Platform family: Douyin Creator Marketplace (Xingtu)
Skill slug: justoneapi-douyin-xingtu-get-kol-spread-info

Operation	Version	Method	Path	OpenAPI summary
`getKolSpreadInfoV1`	`v1`	`GET`	`/api/douyin-xingtu/get-kol-spread-info/v1`	Spread Metrics

Inputs

Parameter	In	Required by	Optional by	Type	Notes
`acceptCache`	`query`	n/a	all	`boolean`	Enable cache
`flowType`	`query`	n/a	all	`string`	Flow type
`kolId`	`query`	all	n/a	`string`	KOL ID
`onlyAssign`	`query`	n/a	all	`boolean`	Only assigned notes
`range`	`query`	n/a	all	`string`	Time range. Available Values: - `_2`: Last 30 days - `_3`: Last 90 days
`range` enum	values	n/a	n/a	n/a	`_2`, `_3`
`type`	`query`	n/a	all	`string`	Spread info type. Available Values: - `_1`: Personal Video - `_2`: Xingtu Video
`type` enum	values	n/a	n/a	n/a	`_1`, `_2`

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use getKolSpreadInfoV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: getKolSpreadInfoV1.

node {baseDir}/bin/run.mjs --operation "getKolSpreadInfoV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"kolId":"<kolId>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.

Environment

Required: JUST_ONE_API_TOKEN
Pass the token with --token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs.
Get a token from Just One API Dashboard.
Authentication details: Just One API Usage Guide.

Output Focus

State the operation ID and endpoint path used, for example getKolSpreadInfoV1 on /api/douyin-xingtu/get-kol-spread-info/v1.
Echo the required lookup scope (kolId) before summarizing results.
Prioritize fields that support this endpoint purpose: Get Douyin Creator Marketplace (Xingtu) spread metrics data, including audience, content performance, and commercial indicators, for quick evaluation.
Return raw JSON only after the short, endpoint-specific summary.
If the backend errors, include the backend payload and the exact operation ID.