← Back to Skills Marketplace
justoneapi

TikTok Shop API

by justoneapi · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ✓ Security Clean
164
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install justoneapi-tiktok-shop
Description
Analyze TikTok Shop workflows with JustOneAPI, including product Search and product Details.
README (SKILL.md)

TikTok Shop

This skill wraps 2 TikTok Shop operations exposed by JustOneAPI. It is strongest for product Search and product Details. Expect common inputs such as region, keyword, offset, pageToken, productId.

When To Use It

  • The user needs product Search or product Details on TikTok Shop.
  • The user can provide identifiers or filters such as region, keyword, offset, pageToken.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • searchProductsV1: Product Search — Get TikTok Shop product Search data, including title, price, and sales, for market research and trend analysis, competitor product discovery, and monitoring product popularity in specific regions
  • getTiktokShopProductDetailV1: Product Details — Get TikTok Shop product Details data, including title, description, and price, for building product catalogs, price and stock monitoring, and in-depth product analysis

Request Pattern

  • 2 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are region, keyword, offset, pageToken, productId.
  • 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: searchProductsV1, getTiktokShopProductDetailV1.
  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 TikTok Shop task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using searchProductsV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as region, keyword, offset, 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 API wrapper. Before installing, ensure you trust https://api.justoneapi.com and obtain a token with appropriate (least) privileges. Keep JUST_ONE_API_TOKEN secret, avoid pasting it into logs or public places, and rotate it if you later revoke access. Verify your runtime supports Node's fetch (Node 18+) and review the small bin/run.mjs script if you want to confirm there are no extra network calls or logging of the token.
Capability Assessment
Purpose & Capability
Name/description match the implemented operations (searchProductsV1, getTiktokShopProductDetailV1). Required binary (node) and the JUST_ONE_API_TOKEN credential are appropriate for calling the documented external API.
Instruction Scope
SKILL.md and bin/run.mjs only instruct the agent to call JustOneAPI endpoints with provided parameters and token. There are no instructions to read unrelated files, access other env vars, or send data to any endpoint besides api.justoneapi.com.
Install Mechanism
No install spec is provided (instruction-only behavior with a small included Node script). Nothing is downloaded or extracted; risk from install mechanism is minimal.
Credentials
The only required env var is JUST_ONE_API_TOKEN (declared as primary credential) which is necessary and sufficient to authenticate to the JustOneAPI endpoints; no unrelated secrets or config paths are requested.
Persistence & Privilege
Skill is not forced-always or requesting elevated/persistent platform privileges. It does not modify other skills' configs or request permanent presence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-tiktok-shop
  3. After installation, invoke the skill by name or use /justoneapi-tiktok-shop
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Renamed the "getProductDetailV1" operation to "getTiktokShopProductDetailV1" for clarity and consistency. - Updated documentation and usage instructions to reflect the new operation ID. - No changes to input parameters or authentication requirements. - General documentation refinements for better clarity.
v1.0.5
- Updated the Just One API authentication details link in the Environment section for improved user guidance. - Added referral parameters to the authentication guide URL. - No changes to API endpoints or skill functionality.
v1.0.4
- Updated Just One API dashboard link to include UTM parameters for improved referral tracking. - No functional changes to API operations or parameters.
v1.0.3
Version 1.0.3 - Clarified in SKILL.md that JUST_ONE_API_TOKEN is used only for authenticated Just One API requests. - No changes to skill logic or endpoints; update is documentation-only.
v1.0.2
- Added guidance to keep the `JUST_ONE_API_TOKEN` private and not share it in chat messages, screenshots, or logs. - No functional or API changes; this update only affects documentation and usage instructions.
v1.0.1
- Added instructions on how to obtain a required API token, including links to the Just One API Dashboard and Usage Guide. - Expanded the "Environment" section with authentication details for improved onboarding.
v1.0.0
init
Metadata
Slug justoneapi-tiktok-shop
Version 1.0.6
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is TikTok Shop API?

Analyze TikTok Shop workflows with JustOneAPI, including product Search and product Details. It is an AI Agent Skill for Claude Code / OpenClaw, with 164 downloads so far.

How do I install TikTok Shop API?

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

Is TikTok Shop API free?

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

Which platforms does TikTok Shop API support?

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

Who created TikTok Shop API?

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

💬 Comments