Douyin Creator Marketplace (Xingtu) Spread Metrics API

Call GET /api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1 for Douyin Creator Marketplace (Xingtu) Spread Metrics through JustOneAPI with oAuthorId.

Security Scan

The skill's code, instructions, and requested token are consistent with calling the JustOneAPI endpoint for Douyin/Xingtu spread metrics; nothing requests unrelated credentials or performs unexpected I/O.

Purpose & Capability

Name/description match the actual behavior: the packaged Node script issues an HTTP GET to https://api.justoneapi.com for the documented endpoint. Requiring JUST_ONE_API_TOKEN and node is coherent with the described purpose.

Instruction Scope

SKILL.md instructs the agent to run the included Node helper with --operation, --token, and --params-json; the helper only builds the URL, injects the token as a query parameter, issues the HTTP request, and prints the backend JSON. It does not read unrelated files, environment variables, or contact other endpoints.

Install Mechanism

There is no install spec (instruction-only behavior), and the only included code is a small Node script. Requiring the 'node' binary is proportionate to shipping a .mjs helper; no downloads from arbitrary URLs or archive extraction are present.

Credentials

Only JUST_ONE_API_TOKEN is required (declared as primaryEnv). No other credentials, secrets, or config paths are requested. The token is used solely to authenticate requests to api.justoneapi.com.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system configuration, and has no mechanism for persistent background presence beyond normal invocation.

Assessment

This skill is internally consistent: it needs the JUST_ONE_API_TOKEN and Node to call JustOneAPI's Douyin/Xingtu endpoint and will send the token to https://api.justoneapi.com as a query parameter. Before installing, ensure the token you provide is scoped appropriately (use a limited or revocable token if possible), verify you trust JustOneAPI and their dashboard link, and avoid pasting the token into chat. If you have network-monitoring tools, you can observe the request to confirm it only contacts api.justoneapi.com. If you need stronger protection, request a token with minimal permissions or rotate/revoke the token after use.

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/gw/api/data_sp/get_author_spread_info/v1. Required non-token inputs are oAuthorId. OpenAPI describes it as: Get Douyin Creator Marketplace (Xingtu) spread metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.

Endpoint Scope

• Platform key: douyin-xingtu
• Endpoint key: gw/api/data_sp/get_author_spread_info
• Platform family: Douyin Creator Marketplace (Xingtu)
• Skill slug: justoneapi-douyin-xingtu-gw-api-data-sp-get-author-spread-info

Operation	Version	Method	Path	OpenAPI summary
gwApiDataSpGetAuthorSpreadInfoV1	v1	GET	/api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1	Spread Metrics

Inputs

Parameter	In	Required by	Optional by	Type	Notes
flowType	query	n/a	all	string	Flow type filter. Available Values: - EXCLUDE: Exclude - INCLUDE: Include
flowType enum	values	n/a	n/a	n/a	EXCLUDE, INCLUDE
oAuthorId	query	all	n/a	string	Author's unique ID
onlyAssign	query	n/a	all	boolean	Whether to only include assigned videos
platform	query	n/a	all	string	Platform type. Available Values: - SHORT_VIDEO: Short video - LIVE_STREAMING: Live streaming - PICTURE_TEXT: Picture and text - SHORT_DRAMA: Short drama
platform enum	values	n/a	n/a	n/a	LIVE_STREAMING, PICTURE_TEXT, SHORT_DRAMA, SHORT_VIDEO
range	query	n/a	all	string	Time range. Available Values: - DAY_30: Last 30 days - DAY_90: Last 90 days
range enum	values	n/a	n/a	n/a	DAY_30, DAY_90
type	query	n/a	all	string	Video type. Available Values: - PERSONAL_VIDEO: Personal video - XINTU_VIDEO: Xingtu video
type enum	values	n/a	n/a	n/a	PERSONAL_VIDEO, XINTU_VIDEO

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

Version Choice

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

Run This Endpoint

Supported operation IDs in this skill: gwApiDataSpGetAuthorSpreadInfoV1.

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

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 gwApiDataSpGetAuthorSpreadInfoV1 on /api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1.
• Echo the required lookup scope (oAuthorId) before summarizing results.
• Prioritize fields that support this endpoint purpose: Get Douyin Creator Marketplace (Xingtu) spread metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.
• Return raw JSON only after the short, endpoint-specific summary.
• If the backend errors, include the backend payload and the exact operation ID.