Para assistentes de IA
Uma ferramenta de download que um assistente pode chamar
O GrabGrab é um site normal e uma API HTTP simples. O assistente não precisa controlar um navegador. Ele envia um link do X, ou do TikTok, Vimeo ou Facebook, lê o JSON e salva o arquivo.
Passo 1
Copie uma URL de vídeo público do X, Twitter, TikTok, Vimeo ou Facebook.
Passo 2
Faça POST para https://www.grabgrab.fun/api/download como JSON com os campos url e videoQuality. 1080 é um bom padrão.
Passo 3
Se success for true e type for direct, baixe o campo url com curl -L. Se a CDN bloquear isso, use o proxyUrl assinado em grabgrab.fun.
Passo 4
Diga à pessoa o nome do arquivo. Se a resposta for um erro, mostre esse erro. Não tente o YouTube de novo: ele é recusado de propósito.
A API pública tem um limite por IP. Quando a verificação humana está ativada, quem visita pelo navegador a conclui e os assistentes continuam usando esta chamada direta com o limite menor. Não invente uma chave secreta. As notas completas estão em /llms.txt.
Usar o GrabGrab a partir de um assistente
O assistente precisa de uma conta?
Não. A API pública de download não exige uma conta do GrabGrab.
Um URL do YouTube funciona se a pessoa insistir?
Não. A API devolve youtube_not_supported e não tenta o download.
E se o pedido atingir o limite?
A API devolve HTTP 429 e o código rate_limit. Espere alguns minutos. Não fique repetindo o pedido.
Onde está a descrição legível por máquina?
https://www.grabgrab.fun/llms.txt e https://www.grabgrab.fun/llms-full.txt