FrameFetch — Video Data API for AI Agents | Transcript, Frames, On-Screen Text

# FrameFetch > Agent-first API + MCP that turns any social-video URL (YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, Reddit) into metadata, insights, transcript, parametrically-sampled frames, and on-screen text (OCR). Pay per call; light calls are sub-cent; a free tier exists; agents can pay with x402 (USDC) without an account. ## Core - [Get an API key]: `POST https://framefetch.net/v1/keys` — body `{ email }`. Returns `{ key }` (shown once) with a free tier of 100 calls/month. Self-serve; no human in the loop. - [Search — no URL yet?]: `POST https://framefetch.net/v1/search` — body `{ query, limit?, platform? }`. `query` 2-200 chars; `limit` 1-25 (default 10); `platform` only `"youtube"` today (anything else is a 400). Returns up to `limit` results: `{ url, title, uploader, durationSec, uploadDate, thumbnail, views }` — nothing invented beyond what yt-dlp's flat search returns, and `uploadDate` is null in practice (that field is almost never reported). No LLM, no download. Flat $0.002/call regardless of `limit`, including a genuine zero-result search (a normal 200). Call `/v1/extract` on a hit's `url` — optionally with `ask` — to go from topic to grounded answer in two calls. See https://framefetch.net/youtube-video-search-api. - [Extract endpoint]: `POST https://framefetch.net/v1/extract` — body `{ url, fields[], frames{} }`. `fields` ⊆ `["metadata","insights","transcript","frames","text_overlay","digest","audio_digest","structured","comments","comment_sentiment"]` (default `["metadata"]`). Returns one JSON object with the requested data; `frames` are time-limited signed image URLs; `text_overlay` (on-screen text via OCR — captions burned into the video, price tags, signage) requires `frames` + a frames spec, one result per frame; auto-skipped with a warning (not an error) above 200 estimated frames — keep the frames spec narrow (fps/range) to use it. Auth: `Authorization: Bearer <key>`. Returns 402 when out of credit. Reques

{ "openapi": "3.1.0", "info": { "title": "FrameFetch API", "version": "1.9.1", "description": "Agent-first API that turns any social-video URL (YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, Reddit) into metadata, insights, transcript, parametrically-sampled frames, and on-screen text (OCR). Batch up to 10 URLs in one call, subscribe to a channel for a webhook on every new upload (/v1/watch), get a Markdown view of any extract (?format=md), and opt into a public per