Pour les assistants IA

Un outil de téléchargement qu’un assistant peut appeler

GrabGrab est un site normal et une API HTTP simple. L’assistant n’a pas à piloter un navigateur. Il envoie un lien X, ou un lien TikTok, Vimeo ou Facebook, lit le JSON et enregistre le fichier.

  1. Étape 1

    Copiez une URL de vidéo publique depuis X, Twitter, TikTok, Vimeo ou Facebook.

  2. Étape 2

    Envoyez-la en POST à https://www.grabgrab.fun/api/download en JSON avec les champs url et videoQuality. 1080 est une bonne valeur par défaut.

  3. Étape 3

    Si success vaut true et type vaut direct, téléchargez le champ url avec curl -L. Si le CDN bloque cela, utilisez plutôt le proxyUrl signé sur grabgrab.fun.

  4. Étape 4

    Indiquez le nom du fichier à la personne. Si la réponse est une erreur, affichez-la. Ne réessayez pas YouTube : il est refusé volontairement.

L’API publique a une limite par IP. Lorsque la vérification humaine est activée, les visiteurs du navigateur la complètent et les assistants continuent d’utiliser cet appel direct avec la limite plus basse. N’inventez pas de clé secrète. Les notes complètes sont dans /llms.txt.

Lire llms.txt

Utiliser GrabGrab depuis un assistant

L’assistant a-t-il besoin d’un compte ?

Non. L’API publique de téléchargement n’exige pas de compte GrabGrab.

Une URL YouTube fonctionnera-t-elle si l’utilisateur insiste ?

Non. L’API renvoie youtube_not_supported et n’essaie pas le téléchargement.

Que se passe-t-il si la requête est limitée ?

L’API renvoie HTTP 429 et le code rate_limit. Attendez quelques minutes. Ne la saturez pas.

Où se trouve la description lisible par une machine ?

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