| name | youtube-handling |
| description | Download video/audio, get captions/transcripts, generate AI summaries, analyze comments, take screenshots, and extract metadata from YouTube videos using VidCap.xyz API. Use when working with YouTube content extraction, video summarization, transcript retrieval, comment analysis, or screenshot capture. |
YouTube Handling with VidCap.xyz API
Process YouTube videos: download, caption, summarize, screenshot, analyze comments.
Setup
- Get API key from VidCap.xyz
- Set env:
VIDCAP_API_KEY=your_api_key
Quick Reference
| Task | Endpoint | Key Params |
|---|---|---|
| Video info | GET /api/v1/youtube/info |
url |
| Download | GET /api/v1/youtube/download |
url |
| Captions | GET /api/v1/youtube/caption |
url, locale, ext |
| Summary | GET /api/v1/youtube/summary |
url, model, screenshot |
| Custom summary | POST /api/v1/youtube/summary-custom |
url, prompt |
| Article | GET /api/v1/youtube/article |
url, model |
| Screenshot | GET /api/v1/youtube/screenshot |
url, second |
| Multi-screenshot | GET /api/v1/youtube/screenshot-multiple |
url, second[] |
| Comments | GET /api/v1/youtube/comments |
url, order, includeReplies |
| Search | GET /api/v1/youtube/search |
q, maxResults, order |
Authentication
Header: X-API-Key: <api_key>
# or
Header: Authorization: Bearer <api_key>
Usage Examples
# Get video info
curl "https://vidcap.xyz/api/v1/youtube/info?url=https://youtube.com/watch?v=VIDEO_ID" \
-H "X-API-Key: $VIDCAP_API_KEY"
# Get captions as VTT
curl "https://vidcap.xyz/api/v1/youtube/caption?url=URL&ext=vtt" \
-H "X-API-Key: $VIDCAP_API_KEY"
# Generate summary with screenshots
curl "https://vidcap.xyz/api/v1/youtube/summary?url=URL&screenshot=1" \
-H "X-API-Key: $VIDCAP_API_KEY"
# Screenshot at specific time
curl "https://vidcap.xyz/api/v1/youtube/screenshot?url=URL&second=120" \
-H "X-API-Key: $VIDCAP_API_KEY"
Script Usage
Run the Python script for common tasks:
# Get video info
python scripts/vidcap.py info "https://youtube.com/watch?v=VIDEO_ID"
# Download video
python scripts/vidcap.py download "URL"
# Get captions
python scripts/vidcap.py caption "URL" --locale en --ext vtt
# Generate summary
python scripts/vidcap.py summary "URL" --screenshot
# Custom summary with prompt
python scripts/vidcap.py summary-custom "URL" --prompt "List key points"
# Take screenshot at 2 minutes
python scripts/vidcap.py screenshot "URL" --second 120
# Get comments
python scripts/vidcap.py comments "URL" --order relevance
# Search YouTube
python scripts/vidcap.py search "query" --max-results 20
References
- Content/AI endpoints:
references/api-content.md - Media/Search endpoints:
references/api-media.md - Caption formats:
json3,srv1,srv2,srv3,ttml,vtt - AI models:
GET /api/v1/ai/models