← Back to Skills Marketplace
justoneapi

Douyin (TikTok China) API

by justoneapi · GitHub ↗ · v1.0.10 · MIT-0
cross-platform ✓ Security Clean
222
Downloads
0
Stars
1
Active Installs
11
Versions
Install in OpenClaw
/install justoneapi-douyin
Description
Analyze Douyin (TikTok China) workflows with JustOneAPI, including user Profile, user Published Videos, and video Details across 8 operations.
README (SKILL.md)

Douyin (TikTok China)

This skill wraps 8 Douyin (TikTok China) operations exposed by JustOneAPI. It is strongest for user Profile, user Published Videos, video Details, and video Search. Expect common inputs such as page, keyword, secUid, awemeId, commentId.

When To Use It

  • The user needs user Profile or user Published Videos on Douyin (TikTok China).
  • The task lines up with video Details rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as page, keyword, secUid, awemeId.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getUserDetailV3: User Profile — Get Douyin (TikTok China) user Profile data, including follower counts, verification status, and bio details, for creator research and account analysis
  • getUserVideoListV3: User Published Videos — Get Douyin (TikTok China) user Published Videos data, including captions, covers, and publish times, for account monitoring
  • getDouyinVideoDetailV2: Video Details — Get Douyin (TikTok China) video Details data, including author details, publish time, and engagement counts, for video research, archiving, and performance analysis
  • searchVideoV4: Video Search — Get Douyin (TikTok China) video Search data, including metadata and engagement signals, for content discovery, trend research, and competitive monitoring

Request Pattern

  • 8 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are page, keyword, secUid, awemeId, commentId.
  • All operations in this skill are parameter-driven requests; none require a request body.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: getUserDetailV3, getUserVideoListV3, getDouyinVideoDetailV2, searchVideoV4.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Start with a plain-language answer tied to the Douyin (TikTok China) task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getUserDetailV3, explain why the returned fields answer the user's question.
  • If the user gave filters such as page, keyword, secUid, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears to be a straightforward JustOneAPI Douyin wrapper and is internally consistent. Before installing: (1) Confirm you trust the JustOneAPI service and the skill publisher (homepage: https://api.justoneapi.com). (2) Provide only a JustOneAPI token with least privilege and rotate it if you suspect exposure. (3) Be aware the token is sent as a URL query parameter — it can appear in server logs or referer headers, so avoid pasting tokens into chats/screenshots. (4) If you need stronger assurance, inspect the full bin/run.mjs source locally to verify there are no additional network destinations or hidden behaviors beyond api.justoneapi.com.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The name/description state this is a Douyin (TikTok China) API wrapper and the skill requests JUST_ONE_API_TOKEN and node — exactly what a simple API wrapper needs. The listed operations and parameters (secUid, awemeId, keyword, etc.) match the stated purpose.
Instruction Scope
SKILL.md instructs the agent to select an endpoint, ask for missing parameters, and run the bundled CLI (node bin/run.mjs) with the provided token. The instructions do not direct reading unrelated files or other environment variables, nor do they instruct sending data to endpoints other than api.justoneapi.com.
Install Mechanism
There is no install spec (instruction-only with a bundled run script). The included bin/run.mjs and generated OpenAPI artifacts are local and do not download external code during install. This is a low-risk install posture.
Credentials
Only one credential is required: JUST_ONE_API_TOKEN (declared as the primary credential). This is proportionate to the skill's purpose. Note: the API expects the token as a query parameter named 'token' (per operations), which can increase exposure risk via URL logs or referer headers — users should treat the token as sensitive and avoid pasting it into chats or logs.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no special persistence or elevated privileges. Autonomous invocation is permitted but is the platform default and not combined with other red flags.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-douyin
  3. After installation, invoke the skill by name or use /justoneapi-douyin
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
- Reduced available operations from 9 to 8, reflecting current JustOneAPI endpoints. - Updated main operation names and parameters (e.g., `getUserVideoListV1` → `getUserVideoListV3`, added `commentId` as a common parameter). - Refreshed documentation to match the present API structure and rename endpoints accordingly. - Adjusted guidance, usage instructions, and representative operations in all references.
v1.0.9
- Updated authentication documentation link in the Environment section for clearer guidance. - Changed the Just One API Usage Guide URL to use standard homepage tracking parameters.
v1.0.8
- Updated the Just One API dashboard signup URL with tracking parameters for improved attribution. - No functional or operation changes to the skill logic or capabilities.
v1.0.7
- Clarified that JUST_ONE_API_TOKEN is used only for authenticated Just One API requests in the "Environment" section. - No changes to code or functionality. Documentation update only.
v1.0.6
- Added a security reminder under "Environment" to keep the `JUST_ONE_API_TOKEN` private and not paste it into chat messages, screenshots, or logs. - No other changes to logic or functionality; documentation improvement only.
v1.0.5
- Added guidance on how to obtain and set the required JUST_ONE_API_TOKEN, including new links to the Just One API Dashboard and usage documentation. - Expanded the Environment section to clarify authentication steps.
v1.0.4
rename
v1.0.3
- Updated the skill name from "justoneapi_douyin" to "Douyin (TikTok China) API". - No changes to operations, functionality, or usage instructions. - Updated only SKILL.md for alignment with naming conventions.
v1.0.2
- Expanded skill description to emphasize support for nine Douyin (TikTok China) operations focused on user profile, published videos, video details, and video search. - Outlined representative operations and specified common parameters (e.g., secUid, awemeId, keyword, page). - Updated usage guidance for selecting endpoints and constructing requests. - Clarified output and error handling rules, including field relevance and explicit filter reporting.
v1.0.1
- Added the --token "$JUST_ONE_API_TOKEN" flag to the example command in documentation. - Updated SKILL.md to clarify how to pass the API token in the helper script.
v1.0.0
Initial release of justoneapi-douyin skill: - Provides access to JustOneAPI Douyin (TikTok China) endpoints via HTTP APIs. - Requires the environment variable JUST_ONE_API_TOKEN. - Offers raw API output plus a brief, structured explanation. - Guides users to select the correct endpoint based on generated/operations.md. - Supports command-line invocation for endpoint operations.
Metadata
Slug justoneapi-douyin
Version 1.0.10
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 11
Frequently Asked Questions

What is Douyin (TikTok China) API?

Analyze Douyin (TikTok China) workflows with JustOneAPI, including user Profile, user Published Videos, and video Details across 8 operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 222 downloads so far.

How do I install Douyin (TikTok China) API?

Run "/install justoneapi-douyin" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Douyin (TikTok China) API free?

Yes, Douyin (TikTok China) API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Douyin (TikTok China) API support?

Douyin (TikTok China) API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Douyin (TikTok China) API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.10.

💬 Comments