Channel Subscriptions

Active

—

Channels

—

Videos Stored

—

Add Subscription

YouTube Channel

Tag (optional — comma-separate for multiple)

Webhook URL (optional)

Keyword Filter Pro ?

Comma-separated

Subscriptions

Keyword Alerts

Delivery Log

Quick Pull

API Docs

Settings

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 your API key (find it in Settings):

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

Add VidProxy to Claude Desktop, Cursor, or VS Code. Uses your API key from Settings.

{
  "mcpServers": {
    "vidproxy": {
      "url": "https://vidproxy.pro/mcp",
      "apiKey": "tr_live_xxx"
    }
  }
}

Tools: get_transcript, get_recent_videos, search_videos, list_channels. 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.

Plan & Billing

Loading…

On-Demand Transcript Credits

Loading…

API Key

Use this key to authenticate pull API requests and MCP clients (Claude Desktop, Cursor, n8n, Make, custom scripts). Pass as Authorization: Bearer <key> or X-Api-Key header.

Rotating generates a new key instantly. Your old key stops working immediately.

Account