YouTube data API

Search videos, channels, and playlists; fetch video details, comments, shorts, live streams, and trending. No account, no OAuth — pay per call with x402 or spend a prepaid credit balance with one API key.

15 endpoints$0.005 per callGET · JSON envelopeUSDC · gas sponsored

pay from any of:BasePolygonArbitrumMonadSolana

/api/channel/handle/:handle
/api/channel/path
/api/channel/:id
/api/channel/:id/live-streams
/api/channel/:id/shorts
/api/channel/:id/videos
/api/hashtag/:tag
/api/playlist/:id/videos
/api/search/channel
/api/search/playlist
/api/search/video
/api/shorts/:id
/api/trending
/api/video/:id
/api/video/:id/comments

Also covers: yt

the main one

start here

$0.005 per call

Search video

/api/search/video

Filter the way YouTube itself does — by upload date, duration, and sort order.

try an example

queryrequiredcursoroptionaldurationoptionalfeaturesoptionaluploadDateoptionalsortByoptionallangoptionalgeooptional

API key — optional · stays in your browser

Try it /api/search/video?query=ai+agents&uploadDate=week

opens the payment page in a new tab · $0.005 per call

quick start

Call YouTube in 30 seconds

curl — with a credits API key

curl -H 'Authorization: Bearer bby_live_...' \
  'https://youtube.fetcher.sh/api/search/video?query=lofi'

curl — no key: the x402 challenge

# call without payment to inspect the 402 challenge
curl -i 'https://youtube.fetcher.sh/api/search/video?query=lofi'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

No key yet? Top up once (minimum $1) and the first response contains your bby_live_ key — one balance works across every fetcher.sh service. Generate one.

mcp

Add YouTube to Claude or Cursor

A remote MCP server scoped to this service: your agent gets these tools and nothing else, so the context cost stays small.

mcp config

{
  "mcpServers": {
    "fetcher": { "url": "https://youtube.fetcher.sh/mcp" }
  }
}

reference

All 15 YouTube endpoints

Click any endpoint to open its console: fill the parameters and try it live — the payable URL opens in a new tab, ready for a browser wallet.

docs

Top up once — then hammer all 15 endpoints with one key

One x402 payment funds a credit balance. Every call after that is a plain Bearer request: no signing, no chain round-trip, more requests per second. The same balance works on every fetcher.sh service.

Generate API key your first top-up creates the key — shown once

Agents: paste Set up https://youtube.fetcher.sh/skill.md into your agent — it reads the skill and sets everything up.