AGENT SKILLBY GOOSEWORKS-AI
TikTok search
AT A GLANCE
TikTok search is a social media skill for AI agents. If /.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login. The gooseworks-ai/goose-skills repository on GitHub, maintained by gooseworks-ai, has 912 stars and the MIT license. To add it, run npx skills add gooseworks-ai/goose-skills --skill tiktok-search
- SOURCE REPOSITORY
- gooseworks-ai/goose-skills (opens GitHub in a new tab)
- REPO STARS
- SOURCE REPOSITORY
- LICENSE
- MIT
- CATEGORIES
- SKILL.MD SIZE
- 3.9 KB139 LINES
QUICK ANSWER
- WHAT IT IS01
- If /.gooseworks/credentials. The value is a focused slice of social content judgment, useful when several similar skills cover the same ground.
- INPUTS02
- Context for social content: your goals, audience, constraints, and any source material the skill asks for.
- OUTPUT03
- A ready-to-use result for social content: the analysis, copy, or recommendations the agent produces.
INSTALL
One command adds this skill from its source repository.
npx skills add gooseworks-ai/goose-skills --skill tiktok-searchREAD THE SKILL.MD BELOW BEFORE YOU RUN IT. SKILLS INSTRUCT YOUR AGENT.
SKILL.MD
The full file, as published in the source repository. Copy it, download it or open it on GitHub.
ON THIS PAGE · 17
TikTok Search#
Setup#
Read your credentials from ~/.gooseworks/credentials.json:
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login
All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"
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 Scrape Creators API via Orthogonal to scrape TikTok data including profiles, hashtags, and trending content.
Usage#
Get TikTok Profile#
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/profile","query":{"handle":"charlidamelio"}}'curl -X POST "https://api.orth.sh/v1/run" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/profile","query":{"handle":"charlidamelio"}}'Search Hashtag Videos#
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/search/hashtag","query":{"hashtag":"tech"}}'Get Trending Feed#
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","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"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/profile","query":{"handle":"charlidamelio"}}'User: "What's trending on TikTok?"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/get-trending-feed","query":{"region":"US"}}'User: "What's trending with #tech on TikTok?"
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"scrapecreators","path":"/v1/tiktok/search/hashtag","query":{"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
FAQ
07 QUESTIONS
01What is the TikTok search agent skill?
If /.gooseworks/credentials. It is listed under social media in the 100xLab agent skills directory.
02How do I install TikTok search in Cursor, Claude Code, or Codex?
Run npx skills add gooseworks-ai/goose-skills --skill tiktok-search in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only TikTok search, not every skill in the repository.
03What does the TikTok search SKILL.md cover?
The SKILL.md includes sections on Setup, When to Use, How It Works, Usage, Get TikTok Profile and Search Hashtag Videos. Read the full text on this page or in plain markdown at /resources/agent-skills/gooseworks-ai-goose-skills--tiktok-search--13wsfj1/raw.
04Which agents can use TikTok search?
TikTok search installs with the cross-agent skills installer (npx skills add), which sets it up for agents such as Claude Code, Cursor and Codex. Each agent loads the SKILL.md when you ask for the skill by name.
05What license is TikTok search under?
The gooseworks-ai/goose-skills repository declares the MIT license. Read the license file in the repository before you copy or redistribute the skill.
06Is TikTok search free to use?
Reading, copying and installing TikTok search costs nothing: it is published in a public GitHub repository under the MIT license. Reuse and redistribution follow that license.
07Where is the source of TikTok search?
TikTok search comes from https://github.com/gooseworks-ai/goose-skills, which has 912 GitHub stars. The SKILL.md is at https://github.com/gooseworks-ai/goose-skills/blob/HEAD/skills/social/capabilities/tiktok-search/SKILL.md. The author is gooseworks-ai.
Need an agent workflow built around your stack?
Tell us the workflow you want automated. We reply within 4 working hours (IST).
ATTRIBUTION
TikTok search was written by its original authors and is published in gooseworks-ai/goose-skills (opens GitHub in a new tab) under the MIT license. All rights stay with the original authors.
100xLab did not write, maintain or endorse this skill. This page lists it for discovery. Repo stars belong to the source repository, not to the skill. Review any skill before you install it.