Per gli assistenti IA

Uno strumento di download che un assistente può chiamare

GrabGrab è un sito normale e una semplice API HTTP. L’assistente non deve guidare un browser. Invia un link di X, oppure di TikTok, Vimeo o Facebook, legge il JSON e salva il file.

  1. Passo 1

    Copia un URL di video pubblico da X, Twitter, TikTok, Vimeo o Facebook.

  2. Passo 2

    Invialo in POST a https://www.grabgrab.fun/api/download come JSON con i campi url e videoQuality. 1080 è un buon valore predefinito.

  3. Passo 3

    Se success è true e type è direct, scarica il campo url con curl -L. Se la CDN lo blocca, usa invece il proxyUrl firmato su grabgrab.fun.

  4. Passo 4

    Di’ alla persona il nome del file. Se la risposta è un errore, mostralo. Non riprovare YouTube: viene rifiutato di proposito.

L’API pubblica ha un limite per IP. Quando il controllo umano è attivo, chi visita dal browser lo completa e gli assistenti continuano a usare questa chiamata diretta con il limite più basso. Non inventare una chiave segreta. Le note complete sono in /llms.txt.

Leggi llms.txt

Usare GrabGrab da un assistente

L’assistente ha bisogno di un account?

No. L’API pubblica di download non richiede un account GrabGrab.

Un URL di YouTube funziona se l’utente insiste?

No. L’API restituisce youtube_not_supported e non tenta il download.

Cosa succede se la richiesta è limitata?

L’API restituisce HTTP 429 e il codice rate_limit. Attendi qualche minuto. Non insistere con nuove richieste.

Dov’è la descrizione leggibile dalle macchine?

https://www.grabgrab.fun/llms.txt e https://www.grabgrab.fun/llms-full.txt