Browse documentation

Tool

Find similar creators

Use to discover creators similar to a public TikTok or Instagram account, as recommended by the platform, in recommendation order. YouTube and other platforms are not supported. Each result carries the profile URL and, when known, name, avatar, short bio and follower count; follower counts and bios are often unavailable for Instagram.

POSTtools.read2 credits
POST/openapi/v1/tools/search_similar_creators

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/search_similar_creators \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"@creator"}'

The MCP tool is named cuekoo_search_similar_creators. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

NameTypeRequiredDescription
accountstringRequiredA TikTok or Instagram handle or public profile URL
platformtiktok | instagramOptionaltiktok or instagram; required for a bare handle. YouTube and other platforms are not supportedOne of: tiktok, instagram

Response

NameTypeRequired
itemsobject[] | nullRequired
items[].avatar_urlstringOptional
items[].biostringOptional
items[].display_namestringOptional
items[].followersinteger | nullRequired
items[].handlestringRequired
items[].platformstringRequired
items[].profile_urlstringRequired
items[].size_tierstringRequired
items[].verifiedbooleanRequired

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

2 credits

How credits work