GrabGrab - Video & Audio Downloader

Download videos and audio from 20+ platforms by URL. Powered by GrabGrab.

Supported Platforms (20+)

Workflow

Step 1: Call the GrabGrab API

Use curl via the Bash tool to call the API:

curl -s -X POST "https://www.grabgrab.fun/api/download" \
  -H "Content-Type: application/json" \
  -d '{"url": "<VIDEO_URL>", "videoQuality": "<QUALITY>"}'

Video quality options (ask user if not specified, default to 1080):

• max - Best available quality
• 2160 - 4K
• 1440 - 2K
• 1080 - Full HD (default)
• 720 - HD
• 480 - SD
• 360 - Low
• 144 - Minimum

Download mode options (default to auto):

• auto - Video with audio (default)
• audio - Audio only
• mute - Video without audio

Step 2: Parse the API Response

The API returns JSON. Handle each response type:

Direct download (type: "direct"):

{
  "success": true,
  "type": "direct",
  "url": "https://...",
  "filename": "video.mp4",
  "proxyUrl": "/api/proxy?url=..."
}

Action: Download the file using curl -L -o "".

Picker (type: "picker") — multiple items found (e.g., Instagram carousel):

{
  "success": true,
  "type": "picker",
  "items": [
    {"type": "video", "url": "https://...", "proxyUrl": "/api/proxy?url=..."},
    {"type": "photo", "url": "https://...", "proxyUrl": "/api/proxy?url=..."}
  ]
}

Action: Show the user the list of items and ask which ones to download, or download all videos.

Error:

{
  "success": false,
  "error": "Error message here"
}

Action: Show the error message to the user.

Step 3: Download the File

For direct downloads:

curl -L -o "<filename>" "<download_url>"

For tunnel/redirect URLs that need the proxy, use the signed proxyUrl returned by the API:

curl -L -o "<filename>" "https://www.grabgrab.fun<proxyUrl>"

IMPORTANT: /api/proxy requires a short-lived signature. Do not construct proxy URLs manually; use the proxyUrl field from the API response.

Step 4: Confirm to User

After download completes:

• Report the filename and file size
• Report the download location (current working directory or user-specified path)

Important Notes

• The API has a rate limit of 30 requests per minute. If you get a 429 error, wait and retry.
• Always use -L flag with curl to follow redirects.
• If the user asks for audio only, set downloadMode to "audio".
• If the user wants the best quality, set videoQuality to "max".
• Default download location is the current working directory unless the user specifies otherwise.
• The API automatically detects the platform from the URL — no need to specify the platform manually.

Examples

User: "Download this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Actions:

1. Call API: curl -s -X POST "https://www.grabgrab.fun/api/download" -H "Content-Type: application/json" -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "videoQuality": "1080"}'
2. Parse response to get download URL and filename
3. Download: curl -L -o "filename.mp4" ""
4. Report: "Downloaded filename.mp4 (15.2 MB) to current directory."

User: "Save the audio from this TikTok: https://www.tiktok.com/@user/video/123"

Actions:

1. Call API with downloadMode: "audio": curl -s -X POST "https://www.grabgrab.fun/api/download" -H "Content-Type: application/json" -d '{"url": "https://www.tiktok.com/@user/video/123", "downloadMode": "audio"}'
2. Parse and download the audio file
3. Report the result

User: "/GrabGrab https://www.bilibili.com/video/BV1xx411c7mD"

Actions:

1. Call API with default settings (1080p, auto mode)
2. Download the video
3. Report the result