For Developers
Plug BrainTube into your stack
Programmatic access to every video, transcript, summary, and highlight in your library. REST, MCP, and webhooks — all from a single API key.
REST API
Save videos, query summaries, search transcripts, and pull highlights via a clean HTTPS API.
MCP Server
Native Model Context Protocol server so Claude, Cursor, and other clients can read your library.
Webhooks
Subscribe to events — video processed, summary ready, highlight created — and trigger your own pipelines.
Scoped API Keys
Per-key scopes (read, write, admin) with rotation and audit logs. Built for production.
Typed SDKs
TypeScript SDK shipping today. Python and Go in private beta.
Bulk Import
Migrate hundreds of videos from CSV, OPML, or YouTube playlists in a single call.
30-second quickstart
Save a video and search your library in five lines of code.
quickstart.ts
TypeScript
import { BrainTube } from "@braintube/sdk";
const bt = new BrainTube({ apiKey: process.env.BT_API_KEY });
const video = await bt.videos.save({
url: "https://youtube.com/watch?v=...",
pod: "founder-playbooks",
});
const highlights = await bt.search({
query: "how do you price an early-stage SaaS?",
topK: 5,
});Ready to build?
Free tier includes 1,000 API calls/month. No credit card required.
Start BuildingFrequently asked
- Is the BrainTube API stable?
- Yes. Endpoints under /v1 follow semantic versioning. Breaking changes ship under a new version with at least 6 months of overlap and a documented migration path.
- What are the rate limits?
- Free tier: 1,000 calls/month, 30 req/min. Starter: 10k/month. Pro: 100k/month. Pro Plus: 1M/month. Bulk import endpoints have separate, more generous limits.
- Which SDKs are available?
- TypeScript is GA. Python and Go are in private beta — request access from Settings → Developers. Any HTTPS client can call the REST API directly.
- How do webhooks work?
- Subscribe to events (video.processed, summary.ready, highlight.created) via a signed HMAC-SHA256 callback URL. Retries use exponential backoff with up to 24 hours of attempts.
- Can I scope API keys to read-only access?
- Yes. Each key declares scopes (read, write, admin) at creation and can be rotated or revoked individually. Audit logs record every call.
- Where is my data stored?
- Customer data is stored in EU regions by default with at-rest encryption. Region pinning to US is available on Pro Plus by request.
