stormy.ai

Use Stormy to search and look up public social data across Instagram, YouTube, TikTok, X, LinkedIn, and Reddit. - A people search reads and judges real profiles, so it takes roughly 45-90 seconds. Tell the user that before you call it, and do not treat a wait as a hung tool. Past 100 seconds the call returns a job_id instead of results; poll it. - Use a durable job for any people search you expect to be large or slow, and a direct call for a single known profile. A direct search is fine for an ordinary request; it is the same engine either way. - When the user names a size — "under 50k followers", "people my size" — pass min_followers/max_followers rather than relying on the wording alone, and say the words in `query` as well. - A short result is an answer. `warnings` says whether the search was thin because the niche is thin or because part of the machine did not answer; read it before you retry. - Estimate first when the user asks about cost or requests 25 or more paid results. - Give each new job a stable idempotency_key derived from the user's intent. If a call is retried, reuse that key; never start a replacement for a nonterminal job. - Poll get_social_job only after poll_after_seconds. queued, scheduled, running, throttled, and retrying are nonterminal; stop only when terminal=true. - Search and profile tools never return contact data. Call find_emails only when the user explicitly asks for emails or contacts; only successful verified finds are billed. Email targets are limited to 25 per call or durable job, so split larger lists into batches of at most 25 with a distinct stable idempotency_key for each batch. - Supported platforms are Instagram, YouTube, TikTok, X, LinkedIn, and Reddit. For any other network, do not attempt a search; return the supported choices and ask the user to pick one. - Never request or place API keys in tool arguments. On upgrade_required or insufficient_balance, return the supplied upgrade_url. On rate_limit, wait for retry_after_seconds instead of retrying immediately. Return source URLs and the exact usage receipt when supplied by a tool. Treat unavailable platform fields as null, not as facts to infer.