Youtube fetcher.sh

Twitter/X, YouTube, Reddit, Google e mais - 100+ endpoints no total. Sem conta, sem OAuth, sem assinatura. Pague por chamada em USDC, ou faça um depósito único e use o mesmo saldo em todos eles.

GitHub

Documentação

name: youtube-api description: >- Uma alternativa à API do YouTube no fetcher.sh — pague por chamada em USDC via x402, ou créditos pré-pagos com uma chave Bearer, sem OAuth e sem cota diária. Use quando o usuário quiser pesquisar vídeos do YouTube com filtros por data de upload, duração ou ordem de classificação, pesquisar canais ou playlists, consultar um canal por ID, @handle ou caminho de URL personalizado, listar os vídeos, shorts ou transmissões ao vivo de um canal, buscar detalhes e comentários de um vídeo ou short, listar os vídeos de uma playlist, puxar postagens sob uma hashtag ou verificar vídeos em alta por região. Também cobre pipelines de dados do YouTube, monitoramento de canais, entrada para análise de vídeos e rastreamento de tendências sem os limites de cota diária da API oficial de dados do YouTube. keywords:

youtube
youtube-api
youtube-api-alternative
youtube-data
video-search
x402
ai-agent

API do YouTube

Dados do YouTube sob demanda: pesquisa de vídeos/canais/playlists com filtros reais (data de upload, duração, ordem de classificação), consultas de canal e vídeo, vídeos, shorts, transmissões ao vivo, conteúdos de playlists, comentários, feeds de hashtag e tendências — um único GET HTTP por chamada, pague conforme o uso. Sem projeto no console de desenvolvedor, sem tela de consentimento OAuth, sem cota diária.

URL base: https://youtube.fetcher.sh

Autenticação

Duas formas de pagar, mesmos dados — mecânica completa na habilidade fetcher :

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/search/video?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Toda resposta é { "status": number, "message": string, "data": ... }; o status HTTP reflete status.

Endpoints (15 — todos GET, $0,005/chamada)

Endpoint	O que retorna
`/api/search/video`	Vídeos que correspondem a uma consulta; filtros de data de upload, duração e ordem
`/api/search/channel`	Canais que correspondem a uma consulta
`/api/search/playlist`	Playlists que correspondem a uma consulta
`/api/channel/{id}`	Detalhes do canal por ID
`/api/channel/handle/{handle}`	Detalhes do canal por @handle
`/api/channel/path`	Detalhes do canal por caminho de URL personalizado
`/api/channel/{id}/videos`	Vídeos de um canal
`/api/channel/{id}/shorts`	Shorts de um canal
`/api/channel/{id}/live-streams`	Transmissões ao vivo de um canal
`/api/video/{id}`	Detalhes do vídeo (ou short)
`/api/video/{id}/comments`	Comentários de um vídeo
`/api/shorts/{id}`	Detalhes do short
`/api/playlist/{id}/videos`	Vídeos de uma playlist
`/api/hashtag/{tag}`	Vídeos sob uma hashtag
`/api/trending`	Vídeos em alta, opcionalmente por região

{id} / {handle} / {tag} são parâmetros de caminho. Os opcionais cursor / lang / geo refinam os resultados; query (pesquisa) e channelPath (consulta de caminho) são obrigatórios onde aparecem.

Cenários

Enviados esta semana:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ai agents" -G \
  --data-urlencode "uploadDate=week" \
  "https://youtube.fetcher.sh/api/search/video"

Mais vistos, somente formato longo:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=x402 protocol" -G \
  --data-urlencode "sortBy=view_count" \
  --data-urlencode "duration=long" \
  "https://youtube.fetcher.sh/api/search/video"

Mais recentes primeiro:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=stablecoin payments" -G \
  --data-urlencode "sortBy=upload_date" \
  "https://youtube.fetcher.sh/api/search/video"

Outros valores de uploadDate: hour, today, month, year. Outros valores de duration : short, medium. Outros valores de sortBy: relevance, rating.

Pesquisar canais ou playlists:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=lofi hip hop" -G \
  "https://youtube.fetcher.sh/api/search/channel"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=lofi hip hop" -G \
  "https://youtube.fetcher.sh/api/search/playlist"

Um canal por ID, handle ou caminho personalizado — depois seus vídeos, shorts e transmissões ao vivo:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/handle/mkbhd"

curl -H "Authorization: Bearer $FETCHER_API_KEY" -G \
  --data-urlencode "channelPath=@mkbhd" \
  "https://youtube.fetcher.sh/api/channel/path"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/videos"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/shorts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/live-streams"

Detalhes e comentários de um vídeo, ou detalhes de um short:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/video/dQw4w9WgXcQ"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=top" -G \
  "https://youtube.fetcher.sh/api/video/dQw4w9WgXcQ/comments"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/shorts/abc123XYZ90"

Vídeos de uma playlist, vídeos sob uma hashtag e tendências (por região):

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/playlist/PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI/videos"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/hashtag/shorts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "geo=US" -G \
  "https://youtube.fetcher.sh/api/trending"

MCP

{
  "mcpServers": {
    "youtube": {
      "url": "https://youtube.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Grátis: search_endpoints, describe_endpoint, check_balance. Pagos: fetch_data (qualquer endpoint acima), topup_credits, além do atalho nomeado youtube_search_video. Remova o bloco headers para pagar por chamada com x402 — veja a habilidade fetcher para o fluxo completo.

Erros

400 — parâmetro ausente/inválido (a mensagem o nomeia)
401 — chave desconhecida ou rotacionada
402 — pagamento necessário (desafio x402) ou topup_required (créditos esgotados)
404 — não é um caminho com preço
Sem limites de taxa; sem reembolsos em falhas upstream (a liquidação precede a entrega)

Referência

Configuração completa do agente: https://youtube.fetcher.sh/skill.md
Contrato OpenAPI 3.1: https://youtube.fetcher.sh/openapi.json
Catálogo condensado: https://youtube.fetcher.sh/llms.txt
Pagamento, créditos e aprofundamento em MCP: habilidade fetcher
Site: https://youtube.fetcher.sh