delete_creator_shortlist
ChatGPTPermanently delete an account-owned saved shortlist, its brief, and notes after the user confirms in the app. Requires the current saved version; does not delete creator profiles.
get_creator
ChatGPTUse this for current creator evidence when the user supplies one exact public platform and username. Use render_creator_profile directly when the user asks to see a visual profile. This lookup may consume Influship account or API usage.
get_instagram_profile
ChatGPTRetrieve a live Instagram profile by exact public username, including biography, follower and following counts, verification, and collection time. Optionally include 1–50 recent posts with captions, public links, engagement, and publish times. Engagement rate is calculated from returned posts with visible counts; profile-only lookups return null. Leading @ is accepted. This source-platform lookup costs 0.5 account credits, including requested posts; stored creator evidence is a separate lookup.
get_linked_account
ChatGPTIdentify the account represented by this request’s verified credentials. The opaque ID remains stable across token refresh and reconnection. Use it to distinguish connected accounts; it does not select another account.
get_posts
ChatGPTUse this when the user asks about recent or top-performing posts for one exact public platform and username. Return at most six public posts for content-pattern or performance analysis. This lookup may consume Influship account or API usage.
get_sample_creator
ChatGPTUse 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 preview tool and should not be used for search, discovery, matching, or comparison requests. After showing the preview, explain only that live creator discovery and comparison require connecting an existing Influship account. Do not discuss plans, pricing, credits, upgrades, or purchasing.
get_workspace_updates
ChatGPTRead the latest temporary display update for this account and workspace window. Does not run discovery, consume search usage, or read another account’s state.
match_creators
ChatGPTUse this when the user supplies public platform and username pairs and wants structured campaign-fit scores and reasons without a visual. Use render_creator_comparison directly for a side-by-side view. This analysis may consume Influship account or API usage.
open_creator_workspace
ChatGPTOpen the Influship workspace to discover, inspect, compare, save, and resume creator shortlists. Lists the linked account’s saved work without running a metered search.
open_saved_shortlist
ChatGPTResume one saved shortlist owned by the linked account. Reloads current stored creator evidence; these lookups may consume account usage. Use the saved shortlist reference returned by the workspace or a mention.
render_creator_comparison
ChatGPTUse this directly when the user supplies two to four public platform and username pairs and asks for a visual campaign-fit comparison. Include the complete campaign brief in this call so it works independently. This may consume Influship account or API usage.
render_creator_profile
ChatGPTUse this directly when the user asks to see an Instagram creator or influencer profile for one exact public username. It fetches stored profile evidence plus up to six recent public posts and may consume Influship account or API usage.
render_creator_shortlist
ChatGPTUse this directly when the user asks to discover creators and see an interactive shortlist. Supply the complete campaign brief or discovery criteria in this call so it works independently. If you refine the search, call this tool again with the refined criteria before your final response. Summarize only the creators and ranking returned by the final rendered shortlist; separate searches do not update the displayed app. It searches current Influship data, preserves ranking and evidence, and may consume Influship account or API usage.
save_creator_shortlist
ChatGPTSave up to eight explicit public creator profiles, a name, the full campaign brief, and optional notes to the linked account. Call only when the user asks to save. To update, supply the saved reference and expected_version; never silently overwrite a conflict.
search_creators
ChatGPTUse this when the user gives a creator or influencer name, partial handle, exact handle, or public Instagram profile URL. Return matching public handles. For one exact handle, use get_creator. For topical discovery, use semantic_search_creators. This lookup may consume Influship account or API usage.
search_shortlist_mentions
ChatGPTSearch only the linked account’s saved shortlists for the desktop composer mention picker. Does not perform metered creator discovery.
semantic_search_creators
ChatGPTUse this when the user wants creator candidates for a topic, audience, niche, content style, platform, or campaign brief and does not require the interactive shortlist. Return public profile references and evidence. Use render_creator_shortlist directly when the user asks to see a visual shortlist. This search may consume Influship account or API usage.