discover_trends
ChatGPTWhat is trending: which categories gain or lose momentum against the library, plus the top trending hooks with summaries (trending_hooks). For "which hook styles / patterns are trending", describe the styles the trending_hooks summaries share and link each hook. Momentum is relative per category, not a count of patterns.
fetch
ChatGPTFetch one hook by id. Prefer get_hook: it returns metrics, emotion radar and comment analysis.
find_hooks
ChatGPTSearch real Instagram Reels hooks by topic, country, category or time window. Use when the user wants real examples, viral hooks, or wants example hooks that work right now. For "what's trending" (categories, momentum) use discover_trends. For "this week's", "new" or "latest" hooks pass added_window "7d" (added to Hookest), NOT window (post date). For one item you already have use get_hook; for lookalikes use find_similar_hooks. Only pass values returned by list_filters. Link each hook by its url so the user can open it on Hookest.
find_similar_hooks
ChatGPTNeeds a hook id, slug or URL from a previous result; returns hooks with a similar opening style. For "hooks like <brand or topic>" use find_hooks with query instead. Use when the user says "more like this". Pass same_category true to stay in its niche. To search by topic use find_hooks instead.
generate_hooks
ChatGPTWrite NEW opening lines for a video topic. Uses the user's daily generation quota. To find existing real examples use find_hooks instead.
get_account
ChatGPTReturns the signed-in user's Hookest plan, which features the plan includes and how much of each quota is left. Spends nothing. Also covers how to connect Hookest to other AI apps.
get_creator_signals
ChatGPTWhat changed in the last 7 days for tracked competitors: new posts and follower changes. Without creator it covers all tracked accounts; with a uuid or @handle, one account. Read-only: it returns signals Hookest has already collected, does not contact Instagram and changes nothing. Marking signals as seen is mark_signals_seen.
get_hook
ChatGPTLook up and analyze one hook that is ALREADY in the Hookest library (by id, slug, Hookest URL or Instagram URL): why it works, full metrics, emotion radar and comment analysis (comment_limit for quotes). Accepts a content id, an SEO slug, a Hookest library URL or an Instagram reel/post URL. End with item.full_analysis_url as "View full analysis on Hookest". Not for scoring text the user wrote (score_hook_text) or the user's own video (start_prediction). To download the clip use get_hook_download.
get_hook_download
ChatGPTCreates a new personal download link for the hook clip (the opening seconds, as an mp4) of a hook in the library; the link works for 15 minutes. Each call issues a new link and counts toward the user's daily download limit; nothing is deleted and no outside service is contacted. Not available on every plan. Hookest provides the hook clip only, not the full reel, and this is the only Hookest tool that returns a video file. Saving a hook to the user's list is set_hook_saved.
get_newsletter
ChatGPTWhether the user gets the Weekly Hook Radar email (free; the week's viral hooks added to Hookest, by category), and for which categories. Read-only.
get_prediction
ChatGPTRead the result of the user's video analysis. Without an id it returns the latest finished one. If the user means a different result ("the one that scored low"), call list_predictions and pass its id. If status is queued or running, wait a few seconds and call again.
list_filters
ChatGPTReturns the categories, countries, sort orders and time windows that the other Hookest tools accept, with how many hooks each one currently has. The other tools accept only these values.
list_predictions
ChatGPTThe user's finished video analyses, newest first: score and band only. Use get_prediction with an id for the details.
list_saved_hooks
ChatGPTThe hooks this user saved in their own Hookest library. Use when they talk about "my saved hooks" or "my list". For searching the whole library use find_hooks.
list_tracked_creators
ChatGPTThe accounts this user tracks, their slot usage and each one's status. For what actually happened use get_creator_signals.
lookup_creator
ChatGPTFind out who an account is before tracking them. Tracking does NOT start here: show the user what came back and call track_creator only after they confirm. Uses one lookup from the daily quota.
mark_signals_seen
ChatGPTMark signals the user has read. Pass signal_ids, or creator to clear one account, or mark_all to clear everything.
run_prediction
ChatGPTAfter upload_prediction_video and a successful upload, run the Virality Predictor on it and get the result. Returns the same result as get_prediction.
score_hook_text
ChatGPTMeasure a hook the user or you wrote: word count and how long it takes to say. This is a length check, not a virality score: to score the user's actual video use start_prediction. Never run this on a caption from the library: captions are multi-line and hashtagged, the estimate would be systematically wrong.
search
ChatGPTKeyword search over the Hookest hook library. Prefer find_hooks: it supports categories, countries, time windows and sorting.
search_creators
ChatGPTSearch Instagram for accounts to track when the user does not have a handle yet. Each call costs one lookup from the daily quota, so search once and pick from the results rather than trying many terms. If you already have a handle use lookup_creator.
set_creator_mail_prefs
ChatGPTTurn the tracked-creators email digest on or off, set it to daily or weekly, and choose the minimum importance (1 = everything, 3 = only big changes). Only call when the user asked.
set_creator_muted
ChatGPTSilence or unsilence notifications for one tracked account. This does NOT stop tracking: that is untrack_creator.
set_hook_saved
ChatGPTBookmark a hook in the user's Hookest saved list (true) or remove it (false). This is a bookmark, not a download. Only call when the user explicitly asked.
set_newsletter
ChatGPTSubscribe the user to the Weekly Hook Radar email, change its categories, or unsubscribe. Only call when the user explicitly asked for this in the conversation: it sends email to their account address.
start_prediction
ChatGPTVirality Predictor: scores a video's OPENING (first seconds) 0-100 against proven viral hooks and says what holds it back. Use whenever the user asks, in any words or language, "will my video go viral", "score / rate / grade / review / analyze my video, reel, TikTok or Short", "is my video's hook / opening good", "check my video before posting", "how do I improve my first 3 seconds", "analyze my content / post / clip", or pastes their own reel or a reel not in the library. Always give the user the upload_url in the reply. If the user attached a video in the chat and you can read the file with code, use upload_prediction_video + run_prediction so the score comes back here. Otherwise the official score needs one upload at upload_url. If you can inspect the file yourself (for example by extracting frames), give a quick read of the opening, label it clearly as your own view and not a Hookest score, then send them to upload_url. It does NOT estimate view counts: if asked for views, say so and offer the score. It takes a video FILE, not a link: for an Instagram link, ask the user to save the video and upload it. Returns a Hookest upload link (the user uploads the video to Hookest, not to the chat); calling this spends nothing, the upload does. Then call get_prediction. Uses one video analysis from the user's plan.
track_creator
ChatGPTStarts tracking an account returned by lookup_creator and uses one tracking slot. From then on Hookest collects that account's public Instagram posts and follower counts. Tracking an account that is already tracked changes nothing; untrack_creator reverses it. Intended for an account the user has confirmed in this conversation.
untrack_creator
ChatGPTRemoves the tracking link. If you track them again the feed starts from zero: earlier signals do not come back, and the first report only comes after a fresh baseline round. Only call when the user explicitly asked.
upload_prediction_video
ChatGPTUse when the user attached a video in the chat and you can read the file with code (for example a sandbox). Pass its duration and size; Hookest reserves one analysis and returns a one-time upload URL on files.hookest.com plus a ready curl command. Upload the file, then call run_prediction. mp4 only, up to 32s and 40 MB. If you cannot read the file or reach files.hookest.com, use start_prediction and give the user its upload_url instead.