framefetch
# FrameFetch **One API/MCP call gives an agent clean video data across 6 platforms** — metadata + insights, a Whisper transcript, and parametric frames (pick fps or exact timestamps → pushed to S3). YouTube (incl. Shorts), TikTok, Reddit, Instagram, Pinterest. Agent-first: typed errors, refund-on-fail, result caching. Pay per call via x402 (USDC on Base) or Stripe. ## Endpoints - POST /v1/extract — any combination of metadata/insights/transcript/frames in one call - POST /v1/metadata · /v1/transcript · /v1/frames — shortcuts - GET /v1/platforms — capability matrix · POST /v1/keys — free key + credit ## Example curl -X POST https://framefetch.net/v1/extract -H "Authorization: Bearer <key>" -H "Content-Type: application/json" -d '{"url":"https://youtu.be/...","fields":["metadata","transcript"]}' https://framefetch.net
How to connect
https://framefetch--reyd8777.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(2)-
framefetch_extractExtract structured data from ONE public social-video URL (YouTube incl. Shorts, TikTok, Instagram Reels, Pinterest, Reddit). Purpose: turn a video link into metadata (title, author, duration, date), insights (views/likes/comments), a transcript (captions, or Whisper when there are none — works on TikTok/Reddit too), and/or parametrically-sampled video frames. When to use: you have a video URL and need its text, stats, or frames for analysis, summarization, or grounding a model. When NOT to use:
-
framefetch_platform_capabilitiesReturn a JSON matrix of which data types (metadata, insights, transcript, frames) each supported platform provides — YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, Reddit. Purpose: check what is available for a platform BEFORE calling framefetch_extract, so you only request supported fields. No input required.