CtrlK
BlogDocsLog inGet started
Tessl Logo

tiktok-search

Search TikTok - find profiles, videos, hashtags, and trending content

63

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/social/capabilities/tiktok-search/SKILL.md
SKILL.md
Quality
Evals
Security

TikTok Search

Setup

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Search TikTok for profiles, videos, and hashtag content.

When to Use

  • User asks about a TikTok account
  • User wants to find TikTok videos
  • User asks about trending TikTok content
  • Social media research

How It Works

Uses the ScrapeCreators API through its direct GooseWorks proxy.

Usage

Get TikTok Profile

provider: scrapecreators
method: GET
path: /v1/tiktok/profile
query:
  handle: charlidamelio

Search Hashtag Videos

provider: scrapecreators
method: GET
path: /v1/tiktok/search/hashtag
query:
  hashtag: tech

Get Trending Feed

provider: scrapecreators
method: GET
path: /v1/tiktok/get-trending-feed
query:
  region: US

Parameters

Profile

  • handle (required) - TikTok handle (without @)

Hashtag Search

  • hashtag (required) - Hashtag to search (without #)
  • region (optional) - Region for the proxy
  • cursor (optional) - Cursor for pagination
  • trim (optional) - Set to "true" for a trimmed response

Trending Feed

  • region (required) - Region for the proxy (e.g., "US")
  • trim (optional) - Set to true for a trimmed response

Response

Profile includes:

  • Username and display name
  • Bio/description
  • Follower and following counts
  • Total likes
  • Verified status
  • Profile image

Videos include:

  • Video title/description
  • View count
  • Like count
  • Comment count
  • Video URL

Examples

User: "Look up charlidamelio on TikTok" Use the Get TikTok Profile operation with handle: charlidamelio.

User: "What's trending on TikTok?" Use the Get Trending Feed operation with the user's region, defaulting to US only when appropriate.

User: "What's trending with #tech on TikTok?" Use the Search Hashtag Videos operation with hashtag: tech.

Error Handling

  • success: false — the API may temporarily fail; retry after a few seconds
  • Private accounts cannot be accessed
  • Rate limiting may apply on rapid sequential requests

Tips

  • Remove @ from handles
  • Remove # from hashtags
  • Private accounts cannot be accessed
Repository
gooseworks-ai/goose-skills
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.