Search the video library
search_videosSearch 4,000+ dissected top-performing videos (launch films, product demos, explainers, motion design, interactive/3D, film + music, teasers, UGC ads). Needs a Refs account; a free one is enough (the app asks the user to sign in). Cards carry the REF id, title, maker, length, aspect, still, views, measured metrics (shots, cuts per minute, voice, music) and why each works; films the account's plan doesn't open come back locked. UGC ads (category ugc) are creator-style ads that won on Meta or TikTok or went viral; their metrics add the signal: source, ugc_format, industry, days_running, variants, reach, ctr_pct, budget_level, advertiser and why_it_won. Use it to find references before making a video; pass a ref to get_blueprint or plan_video (those need a Refs account with Pro; the app asks the user to sign in).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | A curated collection: app-store-header: short loops apps use as the App Store product-page header video (iOS 27); saas: launch and demo films from B2B SaaS companies; developer-tools: launch films and demos from developer tools (editors, terminals, APIs); fintech: films from payments, banking and finance products; crypto: launch films from crypto and web3 products; hardware: launch films for physical hardware products; automotive: car and vehicle launch films; robotics: robot and autonomous-machine films; kinetic-type: films led by kinetic typography (moving type); ui-animation: films of animated product UI and transitions; 3d-animation: films made with 3D animation and renders; product-reveal: films built around a product reveal; logo-reveal: logo reveal pieces; data-visualization: films that animate charts, maps and data; before-after: before-and-after films (problem, then result) | |
| sort | No | recommended = only the films a digital product (SaaS, app, AI or dev tool) would copy for its launch film, best first; none = every film, with those recommended ones still first; signal = UGC ads with the strongest winning signal first (days running, CTR percentile, views) | |
| brand | No | A tracked brand, e.g. linear, higgsfield, runway, vercel, openai | |
| limit | No | Default 8 | |
| query | No | Keywords, e.g. 'developer tool launch dark UI', 'founder to camera', 'kinetic type', 'terminal UI launch'. Films matching every word come first; if none does, films matching some of the words (the result then has a note). A REF id or a YouTube, X, TikTok, Instagram Reel, Meta Ad Library or App Store link finds that film. | |
| aspect | No | Frame shape, as cards name it: 16:9 (landscape), 9:16 (vertical/reels), 1:1 (square), 4:5 (portrait feed) | |
| offset | No | ||
| ai_made | No | true = made with AI/code (Claude, Remotion, three.js); false = human-made | |
| category | No | ||
| industry | No | UGC ads: the advertiser's industry | |
| platform | No | UGC ads: where the winning signal comes from (meta = ran on Meta, tiktok = TikTok's top ads, organic = went viral unpaid) | |
| made_with | No | Tool, e.g. claude, remotion, three.js, manim, after effects | |
| ugc_format | No | UGC ads: the format | |
| max_seconds | No | e.g. 30 for short films | |
| min_seconds | No | ||
| min_days_running | No | UGC ads: Meta ads that ran at least this many days (30 = a winner, 60 = strong) |