tiktok-research

# TikTok Research

TikTok content and creator intelligence through SandBase. Search videos, analyze creator profiles, track hashtag performance, discover trending content, and research live streams. Read [the API map](references/sandbase-api-map.md) before selecting a capability.

## Call SandBase capabilities

Use the capability identifiers below as discovery hints, not MCP tool names. Find the matching endpoint with `sandbase_discover(q: "<provider and capability>")`; use its returned `name` in `sandbase_inspect(name: "<returned name>")`. Read `inputSchema`, pricing, and `execute_as`, then call `sandbase_run` using `execute_as.arguments.name` and schema-defined `arguments`. If a `run_id` is returned, poll `sandbase_run_get(run_id: "<returned run_id>")` within the task budget until `completed` or `failed`; report pending or failed runs without resubmitting them automatically.

## Operating principles

- Use TikTok data for content research and market intelligence only.
- Preserve attribution: include video URLs, creator handles, view counts, dates.
- TikTok metrics are volatile — note observation timestamps.
- Never attempt to post, like, comment, or follow on the platform.

## Workflow

### 1. Search and discover

Use `tiktok_app_v3_general_search_result` for keyword/topic video discovery.
Use `tiktok_app_v3_hashtag_search_result` to find hashtags by keyword.
Use `tiktok_app_v3_hashtag_video_list` to get videos under a specific hashtag.
Use `tiktok_app_v3_home_feed` to see what's trending on For You.

### 2. Analyze creators

Use `tiktok_app_v3_creator_info` for creator profile and stats.
Use `tiktok_app_v3_creator_search_insights` for creator search performance.
Use `tiktok_app_v3_creator_search_insights_trend` for creator trend data.
Use `tiktok_app_v3_creator_search_insights_videos` for top-performing videos.

### 3. Analyze content

Use `tiktok_app_v3_one_video` for detailed video metrics.
Use `tiktok_app_v3_multi_video` for batch video analysis.
Use `tiktok_app_v3_music_video_list` for content using specific sounds.
Use `tiktok_app_v3_music_detail` for sound/music metadata.

### 4. Live and commerce

Use `tiktok_app_v3_live_room_info` for live stream details.
Use `tiktok_app_v3_live_ranking_list` for top live creators.
Use `tiktok_app_v3_live_room_product_list` for live commerce research.

## Output

Return: search results, creator analysis (followers, engagement, content themes), hashtag performance, trending content patterns, and competitive insights.

## Example tasks

- "Find trending TikTok videos about [topic] this week."
- "Analyze @creator's TikTok presence — follower growth, top videos, posting pattern."
- "What hashtags are performing best in the [niche] space on TikTok?"
- "Find TikTok creators in [niche] with 100K-1M followers."
- "What sounds/music are trending on TikTok right now?"

Shown under the source repo’s Apache-2.0 license. Read the full folder on GitHub.