Tool

Search creators

Use to find creators on one platform by name, keyword or @handle, through the platform's own account search, in the platform's order (up to 20). TikTok and Instagram match names, handles and keywords, so use them to find creators by topic. YouTube matches channel names only: a topic keyword such as "skincare" returns nothing there, so search YouTube for a channel's name. To find accounts like a given @handle, use search_similar_creators instead. Instagram results have no follower counts, so followers cannot filter them. Each result carries the profile URL and, when known, name, avatar, short bio and follower count.

POSTtools.read2 credits

POST/openapi/v1/tools/search_creators

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/search_creators \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","query":"<string>"}'

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

Arguments

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

Name	Type	Required	Description
`followers`	`under_1k \| 1k_10k \| 10k_100k \| over_100k`	Optional	Optional audience size: under_1k, 1k_10k, 10k_100k or over_100k. Not available on InstagramOne of: under_1k, 1k_10k, 10k_100k, over_100k
`platform`	`tiktok \| instagram \| youtube`	Required	The one platform to search: tiktok, instagram or youtubeOne of: tiktok, instagram, youtube
`query`	`string`	Required	A creator's name, a keyword, or an @handle; 1 to 100 characters

Response

Name	Type	Required
`items`	`object[] \| null`	Required
`items[].avatar_url`	`string`	Optional
`items[].bio`	`string`	Optional
`items[].display_name`	`string`	Optional
`items[].followers`	`integer \| null`	Required
`items[].handle`	`string`	Required
`items[].platform`	`string`	Required
`items[].profile_url`	`string`	Required
`items[].size_tier`	`string`	Required
`items[].verified`	`boolean`	Required

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

Credits

2 credits

How credits work