Youtube Public Api
Read-only YouTube public-data agent skill — search YouTube videos, video/channel/playlist metadata, public comments, related videos, and transcripts, normali...
YouTube Public Reads
Read-only YouTube data API for video, channel, playlist, comments, related-video, search, and transcript research through ReplyNodes prepaid credits with one long-lived Bearer fetcher key.
Setup
- Create a free ReplyNodes account at https://app.replynodes.com/auth.
- The Free plan includes 500 one-time credits and does not require payment setup.
- Open https://app.replynodes.com/developers and create the single long-lived ReplyNodes fetcher API key.
- Store the secret as REPLYNODES_API_KEY in the agent secret store. Never paste it into chat, commit it, or put it in a URL.
- Send it on API calls as Authorization: Bearer YOUR_FETCHER_KEY.
Gateway: https://api.replynodes.com
Authentication
Use one long-lived ReplyNodes fetcher key. Send it on every request as:
Authorization: Bearer YOUR_FETCHER_KEY
Store the real key in the agent's secret configuration. Never put it in prompts, source files, logs, URLs, or returned data. The gateway performs shared control-plane scope and entitlement checks.
Plans and prepaid credits
-
Payment mode:
prepaid_creditonly. -
Free: 500 one-time credits.
-
Developer: 10,000 credits/month at $19/month.
-
Pro: 100,000 credits/month at $99/month.
-
Failed or provider-error requests cost zero; monthly credits do not roll over; paid overage requires an explicit cap.
-
YouTube transcripts cost 200 credits; standard YouTube reads cost 2 credits.
Read-only operations
Every operation is an HTTP GET and reads public data only:
search—GET https://api.replynodes.com/v1/youtube/search. Search public YouTube videos This operation costs 2 prepaid credits.video—GET https://api.replynodes.com/v1/youtube/video/{id}. Fetch public YouTube video metadata This operation costs 2 prepaid credits.channel—GET https://api.replynodes.com/v1/youtube/channel/{id}. Fetch public YouTube channel metadata This operation costs 2 prepaid credits.comments—GET https://api.replynodes.com/v1/youtube/comments/{id}. Fetch public top-level video comments This operation costs 2 prepaid credits.playlist—GET https://api.replynodes.com/v1/youtube/playlist/{id}. Fetch public playlist metadata and items This operation costs 2 prepaid credits.related—GET https://api.replynodes.com/v1/youtube/related/{id}. Fetch related public videos This operation costs 2 prepaid credits.transcript—GET https://api.replynodes.com/v1/youtube/transcript/{id}. Fetch a public video transcript when available This operation costs 200 prepaid credits.
Request and response behavior
- Use
https://api.replynodes.comas the gateway origin. - Encode path parameters and query values; do not put credentials in query strings.
- Preserve the gateway response envelope and request ID when reporting results.
- Treat unavailable upstream data as unavailable; do not fabricate fields or success.
- Do not retry non-idempotent methods: this package has no non-GET methods.
Example
curl -sS https://api.replynodes.com/v1/youtube/capabilities
curl -sS -H "Authorization: Bearer YOUR_FETCHER_KEY" \
"https://api.replynodes.com/v1/youtube/search"
Safety boundaries
This skill has no write, publish, account, follow, or credential-management operation. It must not be used to claim private data access, unauthenticated access, guaranteed availability, or unsupported pricing.
Source and validation
The operation list is generated from services/youtube-fetcher/internal/capabilities/capabilities.go. manifest.json, references/operations.json, and CHECKSUMS.sha256 are generated artifacts; change the catalog or source capability contract and regenerate them together.
- Downloads
- 684All time
- Security audit
- Pass
- Last updated
- 2mo ago
- Current version
- v2.0.1
- License
- MIT-0
