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_profile` with 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`.