search_videos
search_videos
Find public social videos by topic, creator, hashtag, or keyword. Returns a ranked list of matching videos with URLs, engagement stats, and thumbnails — no video URLs required up front.Returns: array of video result objects, each with
string
required
The search query — a topic, keyword, hashtag, product, or creator handle. For example:
"skincare morning routine", "#fyp AI tools", or "@mkbhd".string
Filter results to a specific platform:
youtube, tiktok, instagram, x, or facebook. Omit to search across all platforms.number
default:"6"
Number of results to return. Accepts 1–20.
platform, url, title, author, stats (views, likes, comments, shares), duration, thumbnail, and createdAt. Every url can be passed directly into get_video_metadata, get_video_transcript, or extract_from_video.get_video_metadata
get_video_metadata
Fetch structured metadata for any public video URL. Returns synchronously with no polling.Returns: platform, title, description, author info, view/like/comment/share counts, duration, thumbnails, tags, and publish timestamp.
string
required
Public video URL from YouTube, TikTok, Instagram, X/Twitter, or Facebook.
get_video_transcript
get_video_transcript
Return the complete transcript for a video. The server handles all async polling internally — your agent receives the finished result when the job is done.Returns: completed transcript job object with full text and timestamps.
string
required
Public video URL or direct media file URL.
string
default:"auto"
Transcription strategy:
native— use platform-provided captions onlygenerate— run AI speech-to-text onlyauto— try native captions first, fall back to AI speech-to-text
string
Language hint for transcription, e.g.
en, es, ur. Optional.extract_from_video
extract_from_video
Ask any question about a video and receive a structured answer. Optionally constrain the output shape with a JSON Schema. The server handles all async polling internally.Returns: completed extraction job object with the structured result.Example prompts:
string
required
Public video URL or direct media file URL.
string
required
What to extract or analyze from the video. Up to 4096 characters.
string
Language hint for transcription, e.g.
en, es, ur. Optional.object
JSON Schema to constrain the structure of the extraction output. Optional.
"Extract the hook, main argument, and call to action""List every product mentioned with the timestamp it appears""What claims does the speaker make? Rate each one as factual, opinion, or unverified""Rewrite this as a Twitter thread"
get_tiktok_profile
get_tiktok_profile
Fetch a TikTok creator’s public profile snapshot. Returns author info, total video count, and recent videos with full per-video engagement stats.Returns: author bio and stats, plus an array of recent videos. Each video object includes views, likes, comments, shares, caption, hashtags, thumbnail, and publish timestamp. You can pass any video’s URL directly into
string
TikTok username, with or without the leading
@. Required if url is not provided.string
Full TikTok profile URL, e.g.
https://www.tiktok.com/@creator. Required if username is not provided.number
default:"12"
Number of recent videos to return. Accepts 1–24.
get_video_transcript or extract_from_video.get_instagram_profile
get_instagram_profile
Fetch an Instagram creator’s public profile snapshot. Returns verified status, follower and following counts, total post count, and recent content.Returns: author bio, verified flag, follower/following/post counts, and an array of recent posts. Each post includes its type (
string
Instagram username, with or without the leading
@. Required if url is not provided.string
Full Instagram profile URL, e.g.
https://www.instagram.com/creator/. Required if username is not provided.number
default:"12"
Number of recent posts to return. Accepts 1–24.
video, post for images, or sidecar for carousels), along with views, likes, comments, caption, and publish timestamp. Video posts also include a direct videoUrl you can pass into get_video_transcript.Chaining tools together
The profile tools are designed to feed directly into the video tools. Here is a complete example that audits a creator without you supplying a single video URL:1
Fetch the profile
Call
get_instagram_profile with a username to get the creator’s recent posts and engagement stats.2
Get the transcript
Pass a
videoUrl from the profile response into get_video_transcript.3
Extract structured data
Pass the same URL into
extract_from_video with a targeted prompt.