Skip to main content
Uses credits · Your own key only
Searches TikTok, Instagram or YouTube for short videos and ranks the ones that did far better than usual first. Takes 5-15 s and uses a few Constella credits. Call it at POST /platform/v1/me/tools/videos_find. On MCP, your AI tool calls videos_find with the same arguments.

Arguments

Send these inside arguments.
string
required
Plain words, "#tag" for a hashtag, or "@handle" for one creator.
string
default:"\"tiktok\""
tiktok, instagram or youtube.
string
default:"null"
The next_cursor from the last call, for more.
integer
default:"20"
1-50.

Returns

The tool’s answer comes back under result.
Video[]
A Video has platform, id, url, author, followers, caption, views, likes, comments, shares, saves, posted_at, duration_s, thumbnail, video and outlier (how many times better than usual).
string
Pass it back for more.