Tiktok search

Skill gooseworks-ai/goose-skills/skills/social/capabilities/tiktok-search

Library of Growth & GTM skills + data APIs for Claude Code, Codex, Cursor to run ads, social, content, lead gen, seo and data scraping

Install

npx -y skills add gooseworks-ai/goose-skills --skill tiktok-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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

SKILL.md

4.0 KB, as published. Nobody here has run it

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"}}'

<details> <summary>curl equivalent</summary>

curl -X POST "https://api.orth.sh/v1/run" \

  -H "Content-Type: application/json" \
  -d '{"api":"scrapecreators","path":"/v1/tiktok/profile","query":{"handle":"charlidamelio"}}'

</details>

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