Youtube fetcher.sh

Twitter/X, YouTube, Reddit, Google y más: más de 100 endpoints en total. Sin cuenta, sin OAuth, sin suscripción. Paga por llamada en USDC, o recarga una vez y gasta un saldo en todos ellos.

GitHubPrueba este MCPPatrocinado

Documentación

name: youtube-api description: >- Una alternativa a la API de YouTube en fetcher.sh: pago por llamada en USDC mediante x402, o créditos prepagados con una clave Bearer, sin OAuth y sin cuota diaria. Úsalo cuando el usuario quiera buscar videos de YouTube con filtros por fecha de subida, duración u orden de clasificación, buscar canales o listas de reproducción, consultar un canal por ID, @handle o ruta de URL personalizada, listar los videos, shorts o transmisiones en vivo de un canal, obtener los detalles y comentarios de un video o short, listar los videos de una lista de reproducción, extraer publicaciones bajo un hashtag o consultar videos de tendencia por región. También cubre pipelines de datos de YouTube, monitoreo de canales, entrada para análisis de videos y seguimiento de tendencias sin los límites de cuota diaria de la API oficial de datos de YouTube. keywords:

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

API de YouTube

Datos de YouTube bajo demanda: búsqueda de videos/canales/listas de reproducción con filtros reales (fecha de subida, duración, orden de clasificación), consultas de canales y videos, videos, shorts, transmisiones en vivo, contenido de listas de reproducción, comentarios, feeds de hashtags y tendencias — una simple solicitud HTTP GET por llamada, con pago por uso. Sin proyecto de consola de desarrollador, sin pantalla de consentimiento OAuth, sin cuota diaria.

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

Autenticación

Dos formas de pagar, mismos datos: mecánica completa en la habilidad 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.

Cada respuesta es { "status": number, "message": string, "data": ... }; el código de estado HTTP refleja status.

Endpoints (15 — todos GET, $0.005/llamada)

Endpoint	Qué devuelve
`/api/search/video`	Videos que coinciden con una consulta; filtros de fecha de subida, duración y orden
`/api/search/channel`	Canales que coinciden con una consulta
`/api/search/playlist`	Listas de reproducción que coinciden con una consulta
`/api/channel/{id}`	Detalles del canal por ID
`/api/channel/handle/{handle}`	Detalles del canal por @handle
`/api/channel/path`	Detalles del canal por ruta de URL personalizada
`/api/channel/{id}/videos`	Videos de un canal
`/api/channel/{id}/shorts`	Shorts de un canal
`/api/channel/{id}/live-streams`	Transmisiones en vivo de un canal
`/api/video/{id}`	Detalles de un video (o short)
`/api/video/{id}/comments`	Comentarios de un video
`/api/shorts/{id}`	Detalles de un short
`/api/playlist/{id}/videos`	Videos de una lista de reproducción
`/api/hashtag/{tag}`	Videos bajo un hashtag
`/api/trending`	Videos de tendencia, opcionalmente por región

{id} / {handle} / {tag} son parámetros de ruta. Los opcionales cursor / lang / geo refinan los resultados; query (búsqueda) y channelPath (consulta de ruta) son obligatorios donde aparecen.

Escenarios

Subido 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"

Más visto, solo formato largo:

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"

Más reciente primero:

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"

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

Buscar canales o listas de reproducción:

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"

Un canal por ID, handle o ruta personalizada — luego sus videos, shorts y transmisiones en 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"

Detalles y comentarios de un video, o detalles de un 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"

Videos de una lista de reproducción, videos bajo un hashtag y tendencias (por región):

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_..." }
    }
  }
}

Gratis: search_endpoints, describe_endpoint, check_balance. De pago: fetch_data (cualquier endpoint anterior), topup_credits, además del atajo nombrado youtube_search_video. Elimina el bloque headers para pagar por llamada con x402 en su lugar — consulta la habilidad fetcher para el flujo completo.

Errores

400 — parámetro faltante o inválido (el mensaje lo indica)
401 — clave desconocida o rotada
402 — pago requerido (desafío x402) o topup_required (créditos agotados)
404 — no es una ruta con precio
Sin límites de tasa; sin reembolsos por fallos del proveedor (el pago se realiza antes de la entrega)

Referencia

Configuración completa del 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
Inmersión profunda en pagos, créditos y MCP: habilidad fetcher
Sitio: https://youtube.fetcher.sh