Search viral videos
search_viral_videosSearch viral short-form videos and posts across YouTube, Instagram, TikTok, X, Reddit, Threads, and LinkedIn (same engine as revid.ai/search). Semantic query plus filters on engagement (min likes/views/shares/comments), platform, language, hashtags, posting date, duration, and AI-analyzed style (mood, content type, perspective, shooting style, visual origin, brand promotion). Each result includes the post URL, a playable video URL when available, the full transcript, a content summary, engagement counts and rate, author info, and hashtags — useful for studying what works before creating content with render_video. Rate limited per plan (free keys get a small daily allowance); a RATE_LIMIT_EXCEEDED error says when the allowance resets.
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_viral_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mood | No | Mood filter. | |
| sort | No | Result order. Default: relevance. | |
| limit | No | Results to return (max 12 per call — backend hard cap). | |
| query | No | Free-text semantic query, e.g. 'AI tools for founders'. Matches meaning, not just keywords. | |
| setting | No | Where the video takes place. | |
| hashtags | No | Hashtags (without #) — results must include at least one. | |
| language | No | ISO language code filter, e.g. 'en'. | |
| minLikes | No | Minimum like count. | |
| minViews | No | Minimum view count. | |
| minShares | No | Minimum share count. | |
| platforms | No | Platforms to search. Defaults to youtube, instagram, tiktok. | |
| viralOnly | No | Only posts in the 'high' or 'viral' engagement tier. TikTok has no tier data, so TikTok results need 100k+ likes instead. | |
| contentType | No | Content format filter. | |
| maxDuration | No | Maximum duration in seconds (TikTok results only). Default 900. | |
| minComments | No | Minimum comment count. | |
| minDuration | No | Minimum duration in seconds (TikTok results only). | |
| perspective | No | Subject perspective filter. | |
| postedAfter | No | Only posts after this date (ISO date or unix seconds). | |
| postedBefore | No | Only posts before this date (ISO date or unix seconds). | |
| visualOrigin | No | Real shot vs AI generated vs animation. | |
| shootingStyle | No | Camera/shooting style filter. | |
| hasBrandPromotion | No | Filter for videos with (true) or without (false) brand promotion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| method | Yes | ||
| status | Yes | ||
| endpoint | Yes | ||
| retryAfterSeconds | No |