get_sample_creator
Use this when a ChatGPT user wants to see what Influship can return before linking an account.
Fetches one configured sample creator with social profile context. This is a low-cost preview tool and should not be used for search, discovery, matching, or lookalike requests.
After showing the preview, tell the user that real live creator data, search, lookalikes, matching, posts, and transcripts require connecting an Influship account. Explain that they can authorize either an Influship SaaS subscription, where usage counts against monthly bundled credits, or an Influship API account, where usage is billed pay-as-you-go under API billing.
search_creators
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`.
semantic_search_creators
Semantic discovery search for influencers/content creators using natural-language queries.
Use this only when the user asks to discover creators by topic, audience, geography,
niche, content style, or campaign criteria (e.g., "fitness creators in NYC", "vegan
recipe creators with high engagement", "tech reviewers who cover phones"). The query
is matched against creator profiles, extracted facts, and visual style via hybrid
vector search.
Do not use this for exact handles, usernames, or known creator names. If the user gives
a specific platform and handle (for example "@niickjackson on Instagram"), use
`get_profile` first. For rough name/handle lookup, use `search_creators`. For
multiple known handles, use `lookup_profiles`. Semantic search can return lookalike
or topical matches and is allowed to miss an exact username.
Examples:
- User: "Find news creators with 1M+ followers" -> use this tool.
- User: "Find creators in LA who make cinematic travel videos" -> use this tool.
- User: "Pull @niickjackson on Instagram" -> use `get_profile`, not this tool.
- User: "Is @niickjackson a fit for Pixel?" -> use `get_profile` first, optionally
`get_posts`, then `match_creators`.
Returns a ranked list of creators (id, platform, username, follower count, engagement
rate, top categories, evidence facts). Use the flat follower, engagement-rate, and
verified fields to constrain results when the user gives concrete numeric constraints.
Use `find_lookalike_creators` instead when you want creators SIMILAR to known ones.
Use `match_creators` when you want to SCORE specific creators against a brief.
autocomplete_creators
Autocomplete creator names, usernames, or display names from partial input.
Use this for fast lookup when the user types a partial handle or name and you need to
resolve it to canonical creator IDs (e.g., "find @cris" or "who's that fitness coach
called Jane?"). Cheap and fast — prefer over `search_creators` for handle-style
queries where the user already knows roughly who they want.
Use `get_profile` instead when the user gives an exact platform+username pair. Use
`search_creators` for the same fuzzy creator lookup behavior with a less typeahead-
specific name. Use `semantic_search_creators` only for discovery by topic, niche,
audience, geography, or content style, not for resolving a known creator.
Examples:
- User: "Who is that fitness coach called Jane?" -> use this tool.
- User: "Find @cris..." -> use this tool to resolve the partial handle.
- User: "Pull @niickjackson on Instagram" -> use `get_profile`, not this tool.
Returns a short list of matching creators with their IDs, platforms, and display names.
Use the IDs returned here as input to `get_creator`, `find_lookalike_creators`, or
`match_creators` for downstream operations.
find_lookalike_creators
Find creators SIMILAR to one or more seed creators.
Use this when the user already knows a creator they like and wants more like them
(e.g., "find creators like @therock", "find more creators like these three I just
booked"). Seeds are blended via creator-profile + visual-style + fact embeddings to
surface similar accounts.
Seeds are passed in `seed_creator_ids` (canonical UUIDs) and/or `seed_profiles`
(platform + username; resolve handles via `autocomplete_creators` first if needed).
Returns a ranked list of similar creators with scores. `limit` caps results
(default 25, max 100). Use the flat follower, engagement-rate, and verified fields
to constrain results.
Use `semantic_search_creators` instead when you have a topic/niche but no seed.
Use `match_creators` when you have specific candidates and want to score their fit
against a brief.
Examples:
- User: "Find creators like @niickjackson on Instagram" -> use this tool with
`seed_profiles: [{ platform: "instagram", username: "niickjackson" }]`.
- User: "Find news creators with 1M+ followers" -> use `semantic_search_creators`,
not this tool.
match_creators
Score how well specific creators fit a campaign brief or search intent.
Use this when the user already has candidate creators in mind and wants to evaluate
fit (e.g., "rate these 5 creators for a vegan cookbook launch", "which of these is
the best match for my crypto audience?"). For each creator the API returns a match
score (0-1), a good/neutral/avoid decision, and structured reasons.
Pass candidates in `creator_ids` (canonical UUIDs) and/or `profiles`
(platform + username). `intent_query` is the brief the LLM reasons against;
`intent_context` is optional extra context (target audience, brand values,
prior collabs).
Use `semantic_search_creators` when you don't have candidates yet and need topical
or niche discovery. Use `search_creators` first when you only need to resolve rough
creator names/handles into candidates.
Use `find_lookalike_creators` when you want creators similar to known good fits.
Examples:
- User: "Is @niickjackson a fit for Pixel?" -> use this tool after resolving the
exact Instagram profile with `get_profile`; call `get_posts` first if recent
content context is needed.
- User: "Rate these five creators for a vegan cookbook launch" -> use this tool.