Any social video → data, in one call.

What you get

Quickstart (REST)

curl -X POST https://framefetch.net/v1/extract \
  -H "Authorization: Bearer <your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=...",
    "fields": ["metadata", "transcript", "frames"],
    "frames": { "mode": "fps", "fps": 1, "width": 480 }
  }'

Returns one JSON object: metadata, insights, transcript, and frames[] as time-limited signed image URLs, plus a cost block. Request only the fields you need. Full guide in the docs.

Endpoints

Method · Path	Purpose
POST /v1/extract	Extract data from a video URL
POST /v1/metadata · /v1/transcript · /v1/frames	Scoped shortcuts (preset fields)
GET /v1/platforms	Capability matrix per platform
POST /v1/keys	Self-serve API key (free credit)
POST /v1/topup	x402 (USDC) credit top-up — no account
POST /mcp	MCP (Streamable HTTP) for agents
GET /healthz	Health check

Machine-readable: OpenAPI spec · llms.txt

For AI agents (MCP)

FrameFetch ships an MCP server with two tools: framefetch_extract and framefetch_platform_capabilities. Add it to your agent and call a video URL directly. Agents can also pay per call with x402 (USDC) — no signup, no human in the loop.

Pricing

Pay per call — light calls (metadata/captions) are sub-cent; transcript is metered per minute; frames are metered per frame. A free tier covers browsing/light use. Pay with prepaid credits, a Stripe card, or x402 (USDC) with no account. Full breakdown on the pricing page.

Why FrameFetch

The only API that returns parametric frames from a social-video URL, includes Reddit-video transcripts, and lets an agent pay without signing up. One clean schema across all six platforms.

FAQ

What does FrameFetch do?

Send one social-video URL; get metadata, insights, transcript, and parametric frames as a single JSON response. Six platforms, one schema.

Can an AI agent pay without an account?

Yes — via x402, an agent pays per call with USDC, no signup or human needed. Humans can use the free tier, prepaid credits, or a Stripe card.

How much does it cost?

Pay per call: metadata sub-cent, transcript per minute, frames per frame. Free credit on signup. See pricing.

Which platforms are supported?

YouTube, YouTube Shorts, TikTok, Instagram Reels, Pinterest, and Reddit.

Is there an MCP server?

Yes, Streamable HTTP at /mcp with framefetch_extract and framefetch_platform_capabilities.