📘 LUDAVIdeo Developer API
Documentación oficial

Bienvenido al ecosistema de Red Wobe.
La LUDAVIdeo Developer API permite integrar el buscador de LUDAVIdeo en cualquier proyecto web de forma sencilla, rápida y sin necesidad de login.

La API está diseñada para no detenerse nunca: cuando la cuota se agota, el servicio continúa funcionando mediante un sistema de penalización por tiempo de espera, en lugar de bloquear el acceso.

📌 Alcance de la API

La API de LUDAVIdeo está enfocada exclusivamente en la búsqueda de videos.

Permite:

• Buscar videos por texto.

• Obtener resultados con título, URL de YouTube, duración y número de vistas.
  
  

No permite:

• Reproducción directa de videos.

• Descarga de contenido.

• Comentarios, likes o suscripciones.

• Acceso a información privada de YouTube.

Los resultados se obtienen mediante procesamiento propio de LUDAVIdeo sobre contenido público de YouTube.

🌐 URL base

https://ludavideo-backend.vercel.app/api

🔍 Formato de consulta

Las búsquedas se realizan mediante una petición GET.

Parámetros:

• key: tu API Key.

• q: texto de búsqueda.

Formato:
/api?key=TU_API_KEY&q=BUSQUEDA

Ejemplo:
/api?key=WOBE_2026&q=minecraft

📦 Respuesta (JSON)

Si la API Key es válida, recibirás una respuesta con este formato:

JSON

[

  {

    "id": {

      "videoId": "videoId"

    },

    "url": "https://www.youtube.com/watch?v=ID",

    "title": "Title",

    "description": "(Normalmente no muestra nada)",

    "duration_raw": "DURACIÓN",

    "snippet": {

      "url": "https://www.youtube.com/watch?v=ID",

      "duration": "DURACIÓN",

      "publishedAt": "(Hace cuando fue publicado)",

      "thumbnails": {

        "id": "IDPORTADA",

        "url": "URL",

        "default": {

          "url": "URL",

          "width": 720,

          "height": 404
},

❌ Códigos de error

400
Formato incorrecto. Parámetros mal escritos o falta el símbolo &.

403
API Key inválida, vencida o sin permisos.

500
Error interno del servidor de búsqueda.

Ejemplo de error:

JSON

{"error":"Key no existe"}

🔄 Versionado

Versión actual: v1 (estable).
Los cambios mayores se publicarán como nuevas versiones.
Las versiones anteriores seguirán funcionando por un tiempo razonable.

⏱ Sistema de cuotas

Para evitar el uso abusivo de API Keys compartidas públicamente, LUDAVIdeo utiliza un sistema de cuotas mensuales.

Cada API Key tiene una cuota asignada.
Las cuotas se reinician automáticamente cada mes, el día 6.
El conteo se aplica por API Key, no por proyecto.

⚠ Penalización de cuota

Cuando la cuota llega a 0, la API no se bloquea.

En su lugar, se activa el sistema de Penalización de cuota:

• Al llegar a 0 búsquedas, cada consulta tendrá 45 segundos adicionales de espera.

• Por cada 2% adicional de uso excedido, se suma 1 segundo extra de espera.

Este sistema garantiza que tu proyecto nunca se caiga, incluso si superas tu cuota mensual.

🔓 Desactivación parcial de la penalización

Puedes solicitar que se desactive el aumento progresivo del delay por cada 2% extra consumido.

Esto no elimina el delay base cuando la cuota llega a 0.
Solo evita que el tiempo de espera siga aumentando.

La solicitud se gestiona manualmente por correo.

💳 Planes (Gratis dependiendo de tu proyecto)

Elige el plan según el tamaño de tu proyecto, no solo por la cuota.
En LUDAVIdeo todos los planes funcionan siempre.

🧪 PRUEBA_FREE
Para probar cómo funciona LUDAVIdeo.

Cuota: 10 búsquedas al mes.
Precio: gratis.

Ideal para curiosos, pruebas rápidas y evaluación de la API.

Penalización:
Al llegar a 0 búsquedas se aplica un delay de 45 segundos, más 1 segundo adicional por cada 2% extra utilizado.

No recomendada para producción.

API Key: PRUEBA_FREE

NO recomendada para proyectos o servicios. Una búsqueda consumirá 10% de tu cuota MENSUAL, si te pasas la penalización será DEMASIADO notoria (5 segs más cada busqueda).

➕ PLUS (Gratis)
Para proyectos personales y prototipos.

Cuota: 1.000 búsquedas al mes.

Ideal para proyectos escolares, apps personales y prototipos funcionales.

Al agotarse la cuota se aplica penalización, pero el servicio nunca se bloquea.

Si tu servicio es personal, educativo o con poco tráfico, es posible que obtengas este plan.

🚀 ILIMITADA BÁSICA (Gratis)
Para proyectos pequeños en producción.

Cuota: 10.000 búsquedas al mes.

Ideal para webs activas, proyectos con usuarios reales y apps en crecimiento.

La penalización solo se activa cuando la cuota llega a 0.

Si tu servicio tiene algunos usuarios activos, es posible que obtengas este plan.

🔥 ILIMITADA MEDIA
Para apps con uso frecuente.

Cuota: 25.000 búsquedas al mes.

Ideal para apps públicas, plataformas educativas y proyectos con tráfico constante.

Gracias al mayor margen de cuota, la penalización es menos perceptible.

Si tu servicio es conocido, es posible que consigas este plan

👑 PREMIUM
Para quienes no quieren pensar en límites.

Cuota: 40.000 búsquedas al mes.

Ideal para productos principales, apps intensivas y demostraciones públicas.

Se puede solicitar desactivar el aumento progresivo del delay por cada 2%.

Si tu servicio es conocido y requiere cantidades masivas de busquedas, es posible que consigas este plan

🧩 PLAN PERSONALIZADO
Hecho a tu medida.

Puedes definir la duración en días y la cuota mensual exacta que necesitas.

Ideal para eventos, apps temporales y casos especiales.

Contacto: Wobe@wobe.abrdns.com

Si tu proyecto no aplica en ninguna, preguntaremos cuanta cuota, duración y por qué los necesitas y si eres aprobado recibiras este plan

🔐 Seguridad

No compartas tu API Key públicamente.
El uso abusivo puede resultar en suspensión.
LUDAVIdeo se reserva el derecho de revocar claves.

🧪 Estado del servicio

La API está en desarrollo activo.
Algunas respuestas pueden variar.
Soporte y reportes: api@wobe.qzz.io

LUDAVIdeo API

Un servicio de Wobe
Creado por Luciano

¡Muchas gracias por el apoyo de todos, de verdad!