SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-chuhaijiang-tiktok-creator

linkfox-chuhaijiang-tiktok-creator

Data & analytics

View repository

Updated 10-16 00:00

About this skill

TikTok Creator Market Intelligence

Use this skill to research public TikTok creator markets: discover creators, inspect one creator, trace their livestreams, products, and videos, or compare agency, commerce, and follower-growth rankings.

Core Concepts

  • Normal endpoints require a lowercase marketplace code.
  • Search and relationship endpoints return at most 10 records per page; ranking endpoints return at most 20.
  • Creator detail can request channel, core, or portrait expansions with a comma-separated include value.
  • Each endpoint call is billed independently. Reuse the 24-hour cache for identical requests; cache identity includes the gateway, API-key fingerprint, endpoint, and parameters.
  • Relationship ownership follows the starting entity: product-to-creator discovery belongs to the product skill; this skill owns creator-to-product, creator-to-live, and creator-to-video drill-downs.

Data Fields

Field Meaning
data.total_count Total matching records when returned
data.items Creator, relationship, or ranking records
id / uid / creator_oecuid Creator identifiers; retain the identifier required by the next endpoint
nickname / unique_id Creator display identity
follower_count Audience size when returned
author_avg_engagement_rate Average engagement metric in creator search
total_video_live_30d_gmv Combined 30-day video and live GMV in creator search
video_30d_gmv / live_30d_gmv Channel-specific 30-day commerce performance

Response fields vary by endpoint and optional detail expansion. Read references/api.md before parsing nested fields and preserve the runtime types returned by the API.

Endpoints

Intent Endpoint Script Points/call
Filter and discover creators /chuhaijiang/creators/search chuhaijiang_creator_search.py 18
Inspect one creator /chuhaijiang/creators/detail chuhaijiang_creator_detail.py 9
Find a creator's livestreams /chuhaijiang/creators/related-lives chuhaijiang_creator_related_lives.py 18
Find a creator's promoted products /chuhaijiang/creators/related-products chuhaijiang_creator_related_products.py 18
Find a creator's videos /chuhaijiang/creators/related-videos chuhaijiang_creator_related_videos.py 18
Browse creator-agency ranking /chuhaijiang/creators/rankings/agencies chuhaijiang_creator_rank_agencies.py 18
Browse commerce-creator ranking /chuhaijiang/creators/rankings/commercial chuhaijiang_creator_rank_commercial.py 18
Browse follower-growth ranking /chuhaijiang/creators/rankings/growth chuhaijiang_creator_rank_growth.py 18

Call only the endpoint required by the user's current question. Ask before making additional paid drill-down calls that the user did not request.

Parameter Guide

  • country: one of br,de,es,fr,gb,id,it,jp,mx,my,ph,sg,th,us,vn in lowercase.
  • id: required for detail and relationship endpoints. Reuse the creator identifier returned by search or ranking results.
  • page: starts at 1. pageSize is optional; use no more than 10 for search/relationships and no more than 20 for rankings.
  • Search supports keyword, category, follower, 30-day GMV, average-view and engagement ranges, hasContact, and sort.
  • Commerce and growth rankings require date (YYYYMMDD) and granularity (daily, weekly, monthly, 0, 1, or 2).
  • Use camelCase request names shown in references/api.md; do not send upstream snake_case names.

How to Call

  • API Endpoints: All 8 LinkFox gateway capabilities use POST; for complete request URLs, parameters, responses, and error codes, see references/api.md。
  • Python Script：python scripts/<entry>.py '<JSON 参数>' [--inline]
  • Cost Constraints: The business entry script caches successful responses for only 24 hours by default; empty results from successful business operations can also be cached; the cache is isolated by the current working directory, calling identity, gateway, endpoint, and complete request parameters. When the same combination is hit, it outputs Cache hit, and will not initiate a new paid request. HTTP or business failures are not cached;--inline does not bypass the cache;--no-cache forces a real request and may consume computing power again; use it only when the user explicitly agrees to additional consumption or during debugging.

Output Strategy (8 influencer business scripts)：

  • Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-chuhaijiang-tiktok-creator-<timestamp>.json；<cwd> is the current working directory when the script is executed; if the current directory is not writable, exit with an error and do not fall back to the user directory or the system temporary directory.
  • Response body ≤ 8 KB: after writing to disk, print the complete JSON to stdout
  • Response body > 8 KB: after writing to disk, stdout outputs the request parameters, top-level status,data.total_count, the length of each business list, and the first 3 samples from the first non-empty business list
  • Add --inline to force full printing to stdout (also written to disk)

Data Reading Suggestions: First look at the summary to determine whether it is sufficient; when specific fields are needed, prefer jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into the context.

Resolve Authentication and Computing Power Issues

When the following abnormal situations occur, use references/onboarding.md to guide problem resolution:

Abnormal Situations

  • API Key Not Configured: The environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code
  • Response indicates insufficient computing power or balance: The message contains "insufficient computing power balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with similar meaning.

Usage Examples

python scripts/chuhaijiang_creator_search.py '{"country":"us","keyword":"beauty","pageSize":5}'
python scripts/chuhaijiang_creator_detail.py '{"country":"us","id":"7302162228386776110","include":"channel,core,portrait"}'
python scripts/chuhaijiang_creator_related_products.py '{"country":"us","id":"7302162228386776110","pageSize":5}'
python scripts/chuhaijiang_creator_rank_growth.py '{"country":"us","date":"20260828","granularity":"daily","pageSize":5}'

Display Rules

  1. State the marketplace, filters, ranking window, total count, and current page when available.
  2. For creator lists, show identity, audience size, engagement, content volume, commerce metrics, category, and creator ID when returned.
  3. For relationship results, show the endpoint-specific live, product, or video metrics and retain the related entity ID for optional drill-down.
  4. Keep currency units and time windows exactly as returned; do not infer a currency or normalize ratios silently.
  5. Separate observed API data from recommendations or interpretations.
  6. Never expose API keys, private contact details, or raw authentication headers.

Important Limitations

  1. Data is public market intelligence and cannot be treated as the user's private TikTok account or CRM data.
  2. This skill does not contact creators, send affiliate invitations, log into accounts, or create campaigns.
  3. Do not invent unsupported filters or compensate for an empty result by repeatedly calling paid endpoints.
  4. Rankings and creator metrics can change over time; report the request date and ranking window.
  5. Contact availability is a search filter, not permission to expose or misuse personal information.

User Expression & Scenario Quick Reference

Applicable:

  • Influencer Discovery and Details: "Use Chuhaijiang to find US TikTok beauty influencers", "Use Chuhaijiang to view this influencer's details".
  • Related Data: "Check this influencer's related live streams", "View this influencer's products and videos".
  • Influencer Rankings: "Use Chuhaijiang to view the influencer follower growth ranking", "Analyze the Chuhaijiang influencer agency ranking", "View the sales influencer ranking".

Adjacent: General TikTok creator searches without a named source should use the existing dedicated creator skills. Product-to-creator discovery starts from a product ID and belongs to the product skill. Requests naming Kalodata, FastMoss, EchoTik, or another provider should use that provider's skill.

Not applicable: private outreach, affiliate invitations, account login, campaign creation, creator impersonation, or extracting unsupported personal data.

Computing Power Consumption Rules

Billing is per endpoint: influencer details 9 computing power/time; influencer search, related live streams, related products, related videos, influencer agency ranking, sales influencer ranking, and influencer follower growth ranking 18 computing power/time.

Users pay fees due to computing power consumption. Before high-frequency calls or multi-endpoint drill-downs, first explain the estimated number of calls and computing power consumption.

Feedback: Use the Feedback API in references/api.md only when the user explicitly asks to submit feedback or explicitly authorizes submission after an issue is identified. Summarize and sanitize the content; never include API keys, creator contact details, raw user messages, or unrelated task context.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.