TikTok Search

Tiktok search

by gooseworks-ai · MIT license · ★ 1,220 on GitHub · updated Sep 21

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

---
name: tiktok-search
description: Search TikTok - find profiles, videos, hashtags, and trending content
source: scrapecreators
---


# 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

Overview

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.

Manual install (npx, ZIP)

Claude Codenpx skills add gooseworks-ai/goose-skills --skill tiktok-search -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/gooseworks-ai/goose-skills/tar.gz/615c685f34f8 \
  | tar -xz -C ~/.claude/skills --strip-components=4 goose-skills-615c685f34f8/skills/social/capabilities/tiktok-search

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/2cb2bb898867ec5759f5/tiktok-search.zip" -OutFile "$env:TEMP\tiktok-search.zip"; Expand-Archive "$env:TEMP\tiktok-search.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md2.5 KB
skill.meta.json322 B

Read the files here

gooseworks-ai/615c6852 files

SKILL.md

Show the full text115 lines

tiktok-search/SKILL.md115 lines · 2.5 KB

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

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

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

1	---
2	name: tiktok-search
3	description: Search TikTok - find profiles, videos, hashtags, and trending content
4	source: scrapecreators
5	---
6
7
8	# TikTok Search
9
10	## Setup
11
12	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.
13
14
15	Search TikTok for profiles, videos, and hashtag content.
16
17	## When to Use
18
19	- User asks about a TikTok account
20	- User wants to find TikTok videos
21	- User asks about trending TikTok content
22	- Social media research
23
24	## How It Works
25
26	Uses the ScrapeCreators API through its direct GooseWorks proxy.
27
28	## Usage
29
30	### Get TikTok Profile
31
32	```yaml
33	provider: scrapecreators
34	method: GET
35	path: /v1/tiktok/profile
36	query:
37	handle: charlidamelio
38	```
39
40	### Search Hashtag Videos
41
42	```yaml
43	provider: scrapecreators
44	method: GET
45	path: /v1/tiktok/search/hashtag
46	query:
47	hashtag: tech
48	```
49
50	### Get Trending Feed
51
52	```yaml
53	provider: scrapecreators
54	method: GET
55	path: /v1/tiktok/get-trending-feed
56	query:
57	region: US
58	```
59
60	## Parameters
61
62	### Profile
63	- handle (required) - TikTok handle (without @)
64
65	### Hashtag Search
66	- hashtag (required) - Hashtag to search (without #)
67	- region (optional) - Region for the proxy
68	- cursor (optional) - Cursor for pagination
69	- trim (optional) - Set to "true" for a trimmed response
70
71	### Trending Feed
72	- region (required) - Region for the proxy (e.g., "US")
73	- trim (optional) - Set to true for a trimmed response
74
75	## Response
76
77	### Profile includes:
78	- Username and display name
79	- Bio/description
80	- Follower and following counts
81	- Total likes
82	- Verified status
83	- Profile image
84
85	### Videos include:
86	- Video title/description
87	- View count
88	- Like count
89	- Comment count
90	- Video URL
91
92	## Examples
93
94	User: "Look up charlidamelio on TikTok"
95	Use the Get TikTok Profile operation with `handle: charlidamelio`.
96
97	User: "What's trending on TikTok?"
98	Use the Get Trending Feed operation with the user's region, defaulting to `US` only when appropriate.
99
100	User: "What's trending with #tech on TikTok?"
101	Use the Search Hashtag Videos operation with `hashtag: tech`.
102
103	## Error Handling
104
105	- success: false — the API may temporarily fail; retry after a few seconds
106	- Private accounts cannot be accessed
107	- Rate limiting may apply on rapid sequential requests
108
109
110	## Tips
111
112	- Remove @ from handles
113	- Remove # from hashtags
114	- Private accounts cannot be accessed
115