SaveVideo
AI Agents & 3rd-Party Integration API

Universal REST API for AI Video & Audio Downloading

Give OpenAI Custom GPTs, Anthropic Claude Tools, LangChain agents, and backend services direct access to download and extract media across 1,000+ platforms with zero captchas and fast CDN streaming.

Single-Shot Execution

No complex 3-step polling required for AI tools. Send the video URL and receive the ready file download link or stream bytes synchronously.

100% CORS & OpenAPI 3.1

Built-in Access-Control-Allow-Origin: * and standard OpenAPI 3.1 definitions for 1-click import into OpenAI Custom GPT Actions.

Private API & Web Frontend

Direct API calls require an authorized private API key (120 req/min). General visitors can download videos freely via our web interface.

Authentication & Private Access

Key Required

Direct access to /api/v1/* requires an authorized private API key passed via headers or query parameters. Ordinary visitors use the website frontend without any API keys.

1. Header (Recommended)

X-API-Key: YOUR_PRIVATE_KEY

2. Bearer Token

Authorization: Bearer YOUR_PRIVATE_KEY

3. Query String

?api_key=YOUR_PRIVATE_KEY

Quickstart & Agent Integration

# 1. Extract metadata & formats
curl -X POST https://savevideo.technofreaks.online/api/v1/info \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_PRIVATE_API_KEY" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# 2. Download media (synchronous - returns ready file link)
curl -X POST https://savevideo.technofreaks.online/api/v1/download \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_PRIVATE_API_KEY" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "format": "mp4", "quality": "1080p"}'

# 3. Direct one-line stream into local file
curl -L "https://savevideo.technofreaks.online/api/v1/stream?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&format=mp4&quality=720p&api_key=YOUR_PRIVATE_API_KEY" -o video.mp4

Live Interactive API Playground

Test API requests right inside your browser. Watch real response payloads and rate-limit headers.

Live Gateway
Response Output
Configure parameters and click "Send Request" to test.

Full API Reference

All routes accept CORS requests, return standard JSON or binary payloads, and support both GET and POST for convenience.

POSTGET/api/v1/info
Probes Video Metadata & Choices

Inspects a video link and returns title, author, duration, thumbnail, and an array of all available video resolutions and audio streams, including direct stream URLs.

// Request Body (POST):
{ "url": "https://www.youtube.com/watch?v=..." }
POSTGET/api/v1/download
Executes Media Transcoding & Download

Prepares a media file with the requested format and resolution. By default runs synchronously (waits up to 45s and returns the ready file URL). Set async: true to get a job ID for background polling.

// Request Body (POST):
{ "url": "https://...", "format": "mp4", "quality": "1080p", "async": false }
GET/api/v1/stream
Direct Binary Stream (curl / CLI)

Streams the raw binary media bytes directly in the HTTP response with Content-Disposition: attachment and HTTP Range 206 resume support.

// CLI Stream Example:
curl -L "https://savevideo.technofreaks.online/api/v1/stream?url=...&format=mp4" -o video.mp4
GET/api/v1/progress
Job Polling for Async Downloads

Checks download progress percentage, current transfer speed, ETA, and returns the final download link once the job transitions to ready.

GET /api/v1/progress?id=job_1730000000_abc123

Need Custom High-Throughput or Dedicated Enterprise Limits?

Contact our engineering team for custom whitelisted IP pools, higher concurrent downloads, or dedicated webhook callbacks.

Contact Support