Para asistentes de IA
Una herramienta de descarga a la que puede llamar un asistente
GrabGrab es un sitio normal y una API HTTP sencilla. El asistente no tiene que manejar un navegador. Envía un enlace de X, o de TikTok, Vimeo o Facebook, lee el JSON y guarda el archivo.
Paso 1
Copia una URL de video público de X, Twitter, TikTok, Vimeo o Facebook.
Paso 2
Haz un POST a https://www.grabgrab.fun/api/download como JSON con los campos url y videoQuality. 1080 es un buen valor predeterminado.
Paso 3
Si success es true y type es direct, descarga el campo url con curl -L. Si la CDN lo bloquea, usa el proxyUrl firmado en grabgrab.fun.
Paso 4
Indica a la persona el nombre del archivo. Si la respuesta es un error, muéstralo. No reintentes YouTube: se rechaza a propósito.
La API pública tiene un límite por IP. Cuando la comprobación humana está activada, quienes visitan desde el navegador la completan y los asistentes siguen usando esta llamada directa con el límite menor. No inventes una clave secreta. Las notas completas están en /llms.txt.
Usar GrabGrab desde un asistente
¿El asistente necesita una cuenta?
No. La API pública de descarga no exige una cuenta de GrabGrab.
¿Funcionará una URL de YouTube si el usuario insiste?
No. La API devuelve youtube_not_supported y no intenta la descarga.
¿Qué pasa si la solicitud está limitada?
La API devuelve HTTP 429 y el código rate_limit. Espera unos minutos. No la satures.
¿Dónde está la descripción legible por máquinas?
https://www.grabgrab.fun/llms.txt y https://www.grabgrab.fun/llms-full.txt