auto-polling active

Channel Subscriptions

Active
—
Channels
—
Videos Detected
—
Add Subscription
You've reached your channel limit on the plan. Upgrade now.
Comma-separated. Whole words or phrases.
Subscriptions
Keyword Alerts
Delivery Log
Quick Pull
Connect & API keys
API Docs
Settings
Loading…
Loading…
Loading…
Quick Pull

Fetch a transcript for any YouTube video without subscribing. Uses your monthly on-demand credits.

Pull History
Loading…
API Reference

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
GET/api/videos?tag=Coffee+News&since=24h
Pull stored videos by tag. 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": "..." }
}
GET/api/subscriptions
List your subscriptions (session auth)
POST/api/subscriptions
Create a subscription (session auth)
{ "channel_input": "@mkbhd", "webhook_url": "https://... (optional)", "label": "Coffee News (optional)" }
POST/api/check-now/:id
Force-deliver latest video for a subscription (session auth)
GET/api/transcript?video_id=dQw4w9WgXcQ
Fetch a transcript for any YouTube video by ID or URL — no channel subscription required. Also accepts ?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
}
MCP — Claude & Cursor
Claude Code, Claude Desktop and claude.ai connect with a browser sign-in (see Settings). For Cursor, VS Code and other clients, use your API key as below.
{
  "mcpServers": {
    "transcripthook": {
      "url": "https://transcripthook.com/mcp",
      "headers": {
        "Authorization": "Bearer tr_live_xxx"
      }
    }
  }
}
Read: get_transcript, get_recent_videos, search_videos, list_channels, get_account_status. Write: add_channel, set_channel_active, remove_channel. Full docs →
Webhook Payload
{
  "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).
Connect your AI assistant

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.

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.

API keys

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.

Loading…

Keys are stored hashed and shown in full only once, when created.

Connected apps

Apps you approved through the browser sign-in. Revoking one cuts off its access immediately.

Loading…
Plan & Billing
Loading…
On-Demand Transcript Credits
Loading…
API keys

API keys moved to Connect & API keys.

MCP permissions
Webhook signing

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

One secret per account, used for every subscription and for test sends.

Account