Volver RAPHAEL // DOCS YT
En Línea
API YouTube Logo
Referencia Técnica

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)