給 AI 助理
助理可以直接呼叫的下載工具
GrabGrab 是普通網站,也是簡單的 HTTP API。助理不必去操作瀏覽器。它傳送 X 連結,或 TikTok、Vimeo、Facebook 連結,讀取 JSON,然後儲存檔案。
第 1 步
複製 X、Twitter、TikTok、Vimeo 或 Facebook 的公開影片連結。
第 2 步
以 JSON 把它 POST 到 https://www.grabgrab.fun/api/download,欄位為 url 與 videoQuality。1080 是合適的預設值。
第 3 步
如果 success 為 true 且 type 為 direct,請用 curl -L 下載 url 欄位。如果 CDN 封鎖了這次下載,改用 grabgrab.fun 上已簽署的 proxyUrl。
第 4 步
把檔名告訴對方。如果回應是錯誤,就原樣顯示。不要重試 YouTube,它是故意拒絕的。
公開 API 有依 IP 的限額。開啟真人驗證後,瀏覽器訪客需要完成驗證,助理則繼續使用這個直接呼叫,並適用較小的限額。不要捏造金鑰。完整說明見 /llms.txt。
透過助理使用 GrabGrab
助理需要帳號嗎?
不需要。公開的下載 API 不需要 GrabGrab 帳號。
如果使用者堅持,YouTube 的 URL 能用嗎?
不能。API 會回傳 youtube_not_supported,並且不會嘗試下載。
如果請求被限流了怎麼辦?
API 會回傳 HTTP 429,代碼為 rate_limit。請等幾分鐘。不要連續猛打。
機器可讀的說明在哪裡?
https://www.grabgrab.fun/llms.txt 與 https://www.grabgrab.fun/llms-full.txt