search_creators
Look up creators by name, handle, or partial identifier. Handles exact matches and ambiguous creator searches, returning autocomplete-style or semantic results.
Instructions
Find a creator by name/handle, while preserving legacy semantic creator search.
Use this as the default creator lookup tool when the user gives a creator-ish string but not a canonical creator UUID: a handle, partial handle, display name, creator name, or profile-ish text. This is cheap, fast, and backed by the creator lookup index.
If the user gives an exact handle on a specific platform (for example "@niickjackson on
Instagram"), prefer get_profile first because it returns the full platform profile.
If you need to resolve a rough creator name or partial handle first, use this tool with
query_type: "creator_lookup".
For backward compatibility, this tool still accepts the old semantic-search fields
(platforms, follower/engagement filters, creator_kinds) and routes legacy calls
to the semantic endpoint unless the query clearly contains a handle/profile URL. For
new topical/niche discovery calls such as "fitness creators in NYC" or "vegan recipe
creators with high engagement", prefer semantic_search_creators because its name is
explicit and less likely to be confused with exact creator lookup.
Examples:
User: "Find @cris" -> use this tool with query "cris" and query_type "creator_lookup".
User: "Who is that fitness coach called Jane?" -> use this tool with query "Jane" and query_type "creator_lookup".
User: "Pull @niickjackson on Instagram" -> use
get_profilewith platform "instagram" and username "niickjackson".User: "Find news creators with 1M+ followers" -> use
semantic_search_creators, not this tool.
Returns either autocomplete-style creator lookup results or legacy semantic results,
depending on routing. Use returned creator IDs with get_creator,
find_lookalike_creators, or match_creators; use returned platform usernames
with get_profile or get_posts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Natural-language semantic discovery query by topic, niche, audience, geography, or content style. Do not pass exact handles or usernames here; use get_profile, lookup_profiles, or autocomplete_creators instead. | |
| platforms | No | Platforms to search. Omit for all. | |
| limit | No | Maximum results to return. | |
| creator_kinds | No | Optional creator kind filter. Omit for no creator-kind filter. | |
| min_followers | No | Minimum follower count. | |
| max_followers | No | Maximum follower count. | |
| min_engagement_rate | No | Minimum engagement rate as a percentage from 0 to 100. | |
| max_engagement_rate | No | Maximum engagement rate as a percentage from 0 to 100. | |
| verified | No | When set, only return verified or unverified creators. | |
| platform | No | Optional platform to narrow username matching. | |
| scope | No | Which linked platforms to include in each lookup result. | all_platforms |
| query_type | No | Use creator_lookup for specific names/handles and semantic_discovery for topical/niche discovery. Auto routes exact handles and profile URLs to lookup, and keeps legacy semantic-search behavior otherwise. | auto |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||