▶️ Documentación API YouTube

Guía de integración para el buscador, extractor de metadatos y descargas multimedia de YouTube.

GET Verificar estado de la API 📊

https://yt-api.raphaelbot.com/health

Ejemplo de resultado:

{
  "status": "OK",
  "message": "API de YouTube Scraper funcionando",
  "endpoints": {
    "public": [
      "/health"
    ],
    "protected": [
      "/search",
      "/metadata",
      "/channel",
      "/ytmp3",
      "/ytmp4"
    ]
  }
}

GET Buscar videos en YouTube 🔎

https://yt-api.raphaelbot.com/search?query=[TEXTO]

Headers requeridos:

x-api-key: [TU_API_KEY]

[TEXTO] = Lo que quieres buscar (Ej: Bad Bunny)
[TU_API_KEY] = Tu clave secreta (Ej: 8affc894-...)
*(Opcional en query params: ?query=[TEXTO]&apiKey=[TU_API_KEY])*

Ejemplo de resultado:

{
  "success": true,
  "results": [
    {
      "title": "Título del Video",
      "url": "https://www.youtube.com/watch?v=...",
      "duration": "3:45",
      "author": "Nombre del Canal"
    }
  ]
}

GET Obtener Metadata de un Video 🎬

https://yt-api.raphaelbot.com/metadata?url=[URL_VIDEO]

Headers requeridos:

x-api-key: [TU_API_KEY]

[URL_VIDEO] = URL completa del video de YouTube (Ej: https://www.youtube.com/watch?v=dQw4w9WgXcQ)

Ejemplo de resultado:

{
  "success": true,
  "data": {
    "title": "Título del Video",
    "description": "Descripción del video...",
    "views": "1000000",
    "likes": "50000",
    "author": "Nombre del Canal"
  }
}

GET Obtener Metadata de un Canal 📺

https://yt-api.raphaelbot.com/channel?channel=[CANAL]

Headers requeridos:

x-api-key: [TU_API_KEY]

[CANAL] = URL del canal o @handle (Ej: @youtube o https://www.youtube.com/@youtube)

Ejemplo de resultado:

{
  "success": true,
  "data": {
    "channelName": "Nombre del Canal",
    "subscribers": "1M",
    "avatar": "https://.../avatar.jpg"
  }
}

GET Descargar Audio MP3 🎵

https://yt-api.raphaelbot.com/ytmp3?url=[URL_VIDEO]&quality=[CALIDAD]

Headers requeridos:

x-api-key: [TU_API_KEY]

[URL_VIDEO] = URL del video de YouTube
[CALIDAD] = Calidad del audio en kbps (Opcional, por defecto: 128)

Ejemplo de resultado:

El archivo MP3 (descarga directa)

GET Descargar Video MP4 🎥

https://yt-api.raphaelbot.com/ytmp4?url=[URL_VIDEO]&quality=[CALIDAD]

Headers requeridos:

x-api-key: [TU_API_KEY]

[URL_VIDEO] = URL del video de YouTube
[CALIDAD] = Calidad del video p.ej. 360, 720, 1080 (Opcional, por defecto: 360)

Ejemplo de resultado:

El archivo MP4 (descarga directa)