YouTube Search channel API

One GET request returns search channel from YouTube as JSON. $0.005 per call, no account and no OAuth — pay with x402 or spend a prepaid balance with one API key.

$0.005 per callGET · JSON envelopeUSDC · gas sponsored

pay from any of:BasePolygonArbitrumMonadSolana

endpointGET /api/youtube/search/channel

queryrequiredcursoroptionalsortByoptionallangoptionalgeooptional

API key — optional · stays in your browser

/api/youtube/search/channel

fill required: query

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

Parameters

name	in	req	values
query	query	required	—
cursor	query	optional	—
sortBy	query	optional	relevance · rating · upload_date · view_count
lang	query	optional	—
geo	query	optional	—

Pay per call (x402)

Call it with no payment and the server answers 402 with machine-readable requirements on Base, Polygon, Arbitrum, Monad or Solana. Sign, retry, done — libraries like @x402/fetch do the loop for you.

curl — the payment challenge

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

Prepaid credits

Top up once and every call is a plain HTTP request against your balance — no signing, no chain round trip. Generate a key.

curl — with your API key

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

Response

Every endpoint returns the same envelope, and the HTTP status mirrors the status field. The upstream payload arrives untouched in data.

200 OK

{
  "status": 200,
  "message": "ok",
  "data": { }
}

All YouTube endpoints: /youtube · machine contract: openapi.json