API Documentation

Pull API

Fetch all transcripts detected for your subscriptions within a time window. Good for batch processing, scheduled jobs, or polling-based integrations.

curl https://vidproxy.pro/api/videos?since=24h&tag=my-channel \
  -H "Authorization: Bearer vp_xxxxxxxxxxxxxxxx"

{
  "videos": [
    {
      "id": 1234,
      "subscription_id": 42,
      "channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "channel_name": "HomeBrewers",
      "tag": "my-channel",
      "video_id": "dQw4w9WgXcQ",
      "video_title": "How to Brew a West Coast IPA",
      "published_at": "2026-04-30T10:00:00.000Z",
      "transcript_available": true,
      "transcript_text": "Welcome to today's brew session...",
      "transcript_source": "proxy",
      "detected_at": "2026-04-30T10:05:12.000Z",
      "ai_summary": null,
      "ai_key_takeaways": null,
      "ai_topics": null
    }
  ],
  "query": {
    "tag": "my-channel",
    "since": "24h",
    "cutoff": "2026-04-29T10:05:12.000Z"
  }
}

Response Fields

MCP — Claude & Cursor Integration

VidProxy ships a Model Context Protocol server at https://vidproxy.pro/mcp. Add it to Claude Desktop, Cursor, VS Code, or any MCP-compatible client and your AI assistant gains direct access to your channel data and transcript lookups — no copy-pasting, no API calls to write.

Setup

Add the following to your MCP client config. For Claude Desktop that's ~/.config/claude/claude_desktop_config.json; for Cursor it's in Settings → MCP.

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

Your API key is in Dashboard → Settings. The MCP server uses the same key as the REST API.

Available Tools

Example prompts

• "Summarize everything my channels posted in the last 24 hours."
• "Search my channels for any video mentioning 'interest rates' this week."
• "Fetch the transcript for youtube.com/watch?v=abc123 and pull out the key points."
• "Which of my channels posted the most content last month?"

Keyword Alerts Pro

Keyword Alerts let you save keywords and receive an email whenever any new video across all your subscriptions mentions them — matched against the video title and transcript. This is separate from per-subscription keyword filters, which control webhook delivery.

Managing alerts

Alerts are managed from the Keyword Alerts tab in your dashboard. Add a keyword, and VidProxy will email you each time a new video matches it. Up to 50 keywords per account.

Match behavior

• Case-insensitive substring match — gpt matches "GPT-4", "ChatGPT", etc.
• Matches run against both the video title and the full transcript text.
• If a transcript is not yet available, the title is checked immediately; the transcript is checked once it becomes available.
• If multiple keywords match the same video, you receive one email listing all matched keywords.

Per-subscription keyword filter

Subscriptions also support a per-subscription Keyword Filter (set in the subscription edit modal). This controls webhook delivery only — the webhook fires only when the video title or transcript matches one of the specified keywords. It does not send emails and is independent of Keyword Alerts.

API

Rate Limits

The Pull API is rate-limited per API key using a sliding 60-second window. Response headers tell you your current usage:

When you exceed the limit you receive a 429 Too Many Requests with a Retry-After header. Back off and retry after that delay.