Parameter
| Parameter | Required | Value |
|---|---|---|
| platform | Yes | tiktok / instagram / twitter / douyin / xiaohongshu / youtube |
| keyword | Yes | Niche or keyword |
| limit | No | Number of items, default 10 |
What it returns
Fields do not depend on the platform: posts return items[] (url, text, author, time, engagement, cover); creators return items[] (handle, name, bio, followers, verified); insights returns sentiment / questions / top_phrases / top_liked / summary.
Using it from an MCP client
No need to memorize parameters — add the endpoint to your client, describe what you want in plain language, and the model picks the tool and arguments itself. Use the REST form above when you write code.
Copy and run
curl -s https://lucydomi.com/mcp/v1/search_creators \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "tiktok", "keyword": "coffee", "limit": 3}'import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/search_creators",
data=json.dumps({"platform": "tiktok", "keyword": "coffee", "limit": 3}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
print(it.get("url"), it.get("text", "")[:60])Real response sample
A real production response below — truncated to one item, billing fields removed.
{
"ok": true,
"platform": "tiktok",
"tool": "search_creators",
"count": 1,
"items": [
{
"platform": "tiktok",
"id": "6746264372110558214",
"handle": "firedeptcoffee",
"name": "Fire Department Coffee",
"bio": "",
"followers": 1177664,
"following": 18,
"posts": 499,
"verified": true,
"avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7350822577939415082~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=9606&idc=no1a&ps=87d6e48a&refresh_token=784d15ef&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1792933200&x-signature=KLH1mYPHpaAF%2Firw4ovA2XPf%2Fog%3D",
"url": "https://www.tiktok.com/@firedeptcoffee"
}
]
}FAQ
How is this different from searching a keyword directly?
Does a bigger sample give more accurate numbers?
Do failed calls count against you?
Related
One key, six platforms
Same fields, same MCP endpoint — switching platform means changing one parameter. New accounts get $0.2 in credit.
View pricing Try it once