Parameter
| Parameter | Required | Value |
|---|---|---|
| platform | Yes | tiktok / instagram / youtube / twitter / douyin / xiaohongshu |
| creator | Yes | Account handle (without the @) or the platform's internal id |
What the profile alone tells you
The follower-to-post ratio, whether the bio names a clear niche, and whether the account is verified — those three alone filter out half the repost and marketing accounts. Engagement quality needs post data, see list_creator_posts.
Response fields
Creators share one structure: handle / name / bio / followers / following / posts / verified / avatar / url. Individual fields may be null on some platforms; the meaning does not change.
Database tips
Use (platform, handle) as the key, re-pull the profile and recent posts once a week, and you can compute follower growth and the change in median engagement — the API only returns snapshots; the growth curve is something you build up yourself.
Copy and run
curl -s https://lucydomi.com/mcp/v1/get_creator \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "tiktok", "creator": "yourcoffeedude"}'import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/get_creator",
data=json.dumps({"platform": "tiktok", "creator": "yourcoffeedude"}).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": "get_creator",
"count": 1,
"items": [
{
"platform": "tiktok",
"id": "7096781983184159749",
"handle": "yourcoffeedude",
"name": "YourCoffeeDude",
"bio": "🔸Aesthetic Homecafe Content🔸\n👇🏽 10% off Earl Grey Matcha 👇🏽",
"followers": 568597,
"following": 13,
"posts": 565,
"verified": false,
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4728264aff2a1d786211f1625624e843~tplv-tiktok-shrink:282:282.jpeg?dr=9622&refresh_token=2be42666&x-expires=1792944000&x-signature=JhqACqKGTbKFdE3fN21iaV5WSGc%3D&t=4d5b0474&ps=13740610&shp=2472a6c6&shcp=9b759fb9&idc=useast5&s=PACK_GO_API",
"url": "https://www.tiktok.com/@yourcoffeedude"
}
]
}FAQ
Can I get emails or business quotes?
Follower count does not match the platform dashboard?
Can the handle include the @?
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