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://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"
}

Action: Download the file using curl -L -o <filename> "<url>".

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

{
  "success": true,
  "type": "picker",
  "items": [
    {"type": "video", "url": "https://..."},
    {"type": "photo", "url": "https://..."}
  ]
}

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:

curl -L -o "<filename>" "https://grabgrab.fun/api/proxy?url=<encoded_download_url>"

IMPORTANT: If the direct URL download fails or returns HTML instead of a video file, retry using the proxy endpoint:

curl -L -o "<filename>" "https://grabgrab.fun/api/proxy?url=$(python3 -c 'import urllib.parse; print(urllib.parse.quote("<download_url>", safe=""))')"

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://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" "<url>" 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://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