ScrollScanner

• Discover top reels — Raw ranked list of a niche's top Reels (outlier score first, then views) with permalinks and metrics. Use for raw data rather than styles (summarize_styles), formats (find_reels) or accounts (discover_creators). Cost: 1 credit per reel returned. Lead with the returned `summary`; outlier_score is null when no creator baseline could be built (ranked on raw views instead). Repeat (or pass `cursor`) for the NEXT batch (14-day exclusion).
• Reel details — FREE. Full stored detail for one Reel any earlier search returned: metrics, outlier score, caption, hashtags, audio, verbatim hook if analyzed. Unknown shortcodes return not_found (no charge) — run a search first, don't retry.
• Explain why a reel worked — Full "why it worked" breakdown of ONE reel a previous search surfaced: verbatim hook, beat-by-beat structure, pacing, format, audio, on-screen text, CTA, transcript, plus why_it_worked and steal_this (tailored to brand_context when given). Cost: 3 credits — FREE when this reel was analyzed before. Works on any shortcode a prior search returned; unknown shortcodes are not_found, no charge. A reel whose video can't be analyzed bills 1 with a limited breakdown.
• Proven hooks — FREE. Seven proven hook formulas — pattern, why it works, examples. With a `niche` already searched, real verbatim hooks fold under each formula (real_examples_in_niche, best first). grounded_in_niche false = run summarize_styles on the niche first; don't retry spellings.
• Hook variants — FREE. Rewrite a hook N ways, each in a different proven archetype with a one-line why_it_works. Source: `hook` text, or `shortcode` for a reel whose hook an earlier search extracted. Sign-in required; 20 calls/day.
• Summarize niche styles — What's working in a niche: finds breakout Reels, groups them into CONTENT STYLES and returns, per style, the hook driving it plus 2-3 example reels. DEFAULT tool for "what's blowing up in <niche>". Cost: 3 credits per reel analyzed (unanalyzable reels bill 1; reels past the 24-per-call cap are free). Not for: one specific format (find_reels) or account lists (discover_creators). Only status=="trend" is corroborated across creators; never present "unclustered" as a pattern. Cite example permali
• Find reels by format — Reels matching ONE specific format, each graded 0-100 against format_description and returned best-first. Use for a precise style hunt ("single-cut talking head selling trades software"). Cost: 3 credits per video returned, low scorers included (an unreviewed video bills 1 and ranks last). Not for: a general "what's working" sweep (summarize_styles). Keywords build the candidate pool; format_description drives the grading (caption-less reels are graded on the video itself). Read relevance as:
• Discover niche creators — The accounts behind a niche's breakout Reels — who to study, benchmark or partner with. Aggregates discovery per creator, filtered to a real topical signal. Cost: 1 credit per creator returned; target_count is a CREATOR count. Follower bands: pass BOTH bounds (e.g. 5000-50000) and lower min_views; unresolved follower counts are dropped (see `note`). Your own seed_accounts are excluded and never billed. Ranked by niche relevance, then outlier score, then breakout count. Repeat (or pass `cursor`
• Account & credits — FREE. Connected account (email, id), credit balance, per-tool credit `rates`. Call once before an expensive run; every paid result already returns `balance`, so don't call it after each search.
• Service health — FREE. Is ScrollScanner ready RIGHT NOW? Probes live capacity (cached ~60s). "degraded" = searches will fail with service_capacity (our side, already alerted) — wait for "operational". Never poll in a loop; follow each error's retry_advice.

Schemas and invoke metadata: Directory API