給 AI 助理

助理可以直接呼叫的下載工具

GrabGrab 是普通網站,也是簡單的 HTTP API。助理不必去操作瀏覽器。它傳送 X 連結,或 TikTok、Vimeo、Facebook 連結,讀取 JSON,然後儲存檔案。

  1. 第 1 步

    複製 X、Twitter、TikTok、Vimeo 或 Facebook 的公開影片連結。

  2. 第 2 步

    以 JSON 把它 POST 到 https://www.grabgrab.fun/api/download,欄位為 url 與 videoQuality。1080 是合適的預設值。

  3. 第 3 步

    如果 success 為 true 且 type 為 direct,請用 curl -L 下載 url 欄位。如果 CDN 封鎖了這次下載,改用 grabgrab.fun 上已簽署的 proxyUrl。

  4. 第 4 步

    把檔名告訴對方。如果回應是錯誤,就原樣顯示。不要重試 YouTube,它是故意拒絕的。

公開 API 有依 IP 的限額。開啟真人驗證後,瀏覽器訪客需要完成驗證,助理則繼續使用這個直接呼叫,並適用較小的限額。不要捏造金鑰。完整說明見 /llms.txt。

閱讀 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