Channel Subscriptions
Fetch a transcript for any YouTube video without subscribing. Uses your monthly on-demand credits.
Authenticate pull API requests with an API key (create one under Connect & API keys):
Authorization: Bearer tr_live_xxx # or X-Api-Key: tr_live_xxx
since accepts 24h, 7d, etc. Omit tag to get all channels. Requires API key.{
"videos": [
{
"channel_name": "James Hoffmann",
"tag": "Coffee News",
"video_id": "abc123",
"video_title": "...",
"published_at": "2026-04-29T10:00:00Z",
"detected_at": "2026-04-29T10:10:00Z",
"transcript_available": true,
"transcript_text": "Full transcript..."
}
],
"query": { "tag": "Coffee News", "since": "24h", "cutoff": "..." }
}
{ "channel_input": "@mkbhd", "webhook_url": "https://... (optional)", "label": "Coffee News (optional)" }
?url=https://youtube.com/watch?v=.... Uses your monthly on-demand credits. Requires API key.{
"video_id": "dQw4w9WgXcQ",
"available": true,
"text": "Full transcript as plain text...",
"segments": [{ "start": 0, "duration": 4, "text": "Never gonna give you up" }],
"credits_remaining": 499
}
{
"mcpServers": {
"transcripthook": {
"url": "https://transcripthook.com/mcp",
"headers": {
"Authorization": "Bearer tr_live_xxx"
}
}
}
}
get_transcript, get_recent_videos, search_videos, list_channels, get_account_status. Write: add_channel, set_channel_active, remove_channel. Full docs →{
"event": "new_video",
"timestamp": "2026-04-29T12:00:00Z",
"subscription": { "id": 1, "label": "My Project", "channel_id": "UC...", "channel_name": "MKBHD" },
"video": { "id": "abc123", "title": "Video Title", "url": "https://...", "published": "..." },
"transcript": {
"available": true,
"text": "Full transcript as plain text...",
"segments": [{ "start": 0, "duration": 3, "text": "Hello everyone" }]
},
"enrichment": {
"summary": "...",
"key_takeaways": ["...", "..."],
"topics": ["seo", "youtube", "content marketing"]
}
}
enrichment is only present on Pro and Agency plans (coming soon).Pick your client. Most clients use browser approval, so there is nothing to copy. Scripts, n8n and anything calling the REST API need an API key: create one under API keys below.
Then run /mcp in Claude Code and choose Authenticate. Your browser opens; log in and approve.
If the form doesn't open pre-filled: Settings → Connectors → Add custom connector, name it TranscriptHook and paste:
Claude Desktop uses the same connectors as your claude.ai account.
In ChatGPT, open Settings → Apps & Connectors, turn on Developer mode under Advanced, then create a connector with this URL and OAuth authentication:
VS Code opens, adds the server, and asks you to sign in to TranscriptHook in your browser.
Cursor desktop signs in through your browser. If sign-in fails (older Cursor versions or Cloud Agents), use the API key method under Other clients.
For clients without OAuth support, pass an API key as a header instead:
Using another client? See the MCP setup docs.
Apps connected through the browser can read your data and add, pause or resume channels. Removing channels is never granted to them. Manage them under Connected apps below.
Use API keys for pull API requests and MCP clients without browser sign-in (n8n, Make, custom scripts).
Pass as Authorization: Bearer <key> or X-Api-Key header.
Create a separate named key for each tool, and revoke one without affecting the others.
Keys are stored hashed and shown in full only once, when created.
Apps you approved through the browser sign-in. Revoking one cuts off its access immediately.
API keys moved to Connect & API keys.
Every webhook we send is signed with this secret: the X-VidProxy-Signature header is an
HMAC-SHA256 of X-VidProxy-Timestamp, a dot, and the raw request body. Checking it proves a
request really came from TranscriptHook. Verifying is optional; receivers that ignore the header keep working.
How to verify
whsec_••••••••••••••••
One secret per account, used for every subscription and for test sends.