Search YouTube for videos and channels, search within specific channels, then fetch transcripts. Use when the user asks to "find videos about X", "search YouTube for", "look up a channel", "who makes
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Search YouTube and fetch transcripts via TranscriptAPI.com.
If
$TRANSCRIPT_API_KEYStep 1 — Register: Ask user for their email.
node ./scripts/tapi-auth.js register --email USER_EMAIL
→ OTP sent to email. Ask user: "Check your email for a 6-digit verification code."
Step 2 — Verify: Once user provides the OTP:
node ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE
API key saved to
. See File Writes below for details. Existing file is backed up before modification.~/.openclaw/openclaw.json
Manual option: transcriptapi.com/signup → Dashboard → API Keys.
The verify and save-key commands save the API key to
~/.openclaw/openclaw.jsonskills.entries.transcriptapi.apiKeyenabled: true~/.openclaw/openclaw.json.bakTo use the API key in terminal/CLI outside the agent, add to your shell profile manually:
export TRANSCRIPT_API_KEY=<your-key>Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.
Search YouTube globally for videos or channels.
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \ -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
| Param | Required | Default | Validation |
|---|---|---|---|
| yes | — | 1-200 chars (trimmed) |
| no | | |
| no | | 1-50 |
Video search response:
{ "results": [ { "type": "video", "videoId": "dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "channelTitle": "Rick Astley", "channelHandle": "@RickAstley", "channelVerified": true, "lengthText": "3:33", "viewCountText": "1.5B views", "publishedTimeText": "14 years ago", "hasCaptions": true, "thumbnails": [{ "url": "...", "width": 120, "height": 90 }] } ], "result_count": 20 }
Channel search response (
type=channel{ "results": [{ "type": "channel", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "title": "Rick Astley", "handle": "@RickAstley", "url": "https://www.youtube.com/@RickAstley", "description": "Official channel...", "subscriberCount": "4.2M subscribers", "verified": true, "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC...", "thumbnails": [...] }], "result_count": 5 }
Search videos within a specific channel. Accepts
channel@handleUC...curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\ ?channel=@TED&q=climate+change&limit=30" \ -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
| Param | Required | Validation |
|---|---|---|
| yes | |
| yes | 1-200 chars |
| no | 1-50 (default 30) |
Returns up to ~30 results (YouTube limit). Same video response shape as global search.
Convert @handle to channel ID:
curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \ -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
# 1. Search for videos curl -s "https://transcriptapi.com/api/v2/youtube/search\ ?q=python+web+scraping&type=video&limit=5" \ -H "Authorization: Bearer $TRANSCRIPT_API_KEY"2. Get transcript from result
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\ ?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true"
-H "Authorization: Bearer $TRANSCRIPT_API_KEY"
| Code | Action |
|---|---|
| 402 | No credits — transcriptapi.com/billing |
| 404 | Not found |
| 408 | Timeout — retry once |
| 422 | Invalid channel identifier |
Free tier: 100 credits, 300 req/min.
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.