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
