VideoFlow API v1

Video downloading API, built for developers.

VideoFlow provides a simple API for retrieving direct video URLs from supported TikTok and YouTube links. Authenticate with your API key and integrate video downloading into your own applications, bots and automation workflows.

Authentication

Every API request requires a valid VideoFlow API key.

Your API key must be sent using the Authorization header with the Bearer scheme.
Authorization Header
Authorization: Bearer vf_live_xxxxxxxxxxxxxxxxx

API keys can be created and managed from your VideoFlow Dashboard. Never expose your secret key in client-side code or commit it to GitHub.

Quickstart

Make your first API request in seconds.

01 — Create an API key

Open your Dashboard and create a new API key. Copy the key immediately because the complete key is only displayed once.

02 — Choose a video URL

Use a supported TikTok or YouTube video URL as the value of the url parameter.

03 — Send the request

Call the Download API with your Bearer token in the Authorization header.

04 — Receive the URL

VideoFlow returns a JSON response containing a direct video URL.

Download Video

Get a direct video URL from a supported TikTok or YouTube URL.

GET /api/download

Query Parameters

url
Required. The TikTok or YouTube video URL.

Response

JSON
{
  "success": true,
  "url": "https://example.com/video.mp4"
}

Live API Playground

Test the VideoFlow API directly from your browser. Your request is sent to the real API.

Try the Download API
Enter your API key and a supported video URL.
Response
—


            

cURL

Use cURL from any terminal.

Bash
curl -X GET "https://vd.syncra.top/api/download?url=VIDEO_URL" \
  -H "Authorization: Bearer vf_live_YOUR_API_KEY"

JavaScript

Use the Fetch API in Node.js or a browser environment.

JavaScript
const apiKey = "vf_live_YOUR_API_KEY";
const videoUrl = "https://www.tiktok.com/...";

const response = await fetch(
  "https://vd.syncra.top/api/download?url=" +
  encodeURIComponent(videoUrl),
  {
    headers: {
      Authorization: `Bearer ${apiKey}`
    }
  }
);

const data = await response.json();

console.log(data);

Python

Integrate VideoFlow into Python applications.

Python
import requests

api_key = "vf_live_YOUR_API_KEY"
video_url = "https://www.tiktok.com/..."

response = requests.get(
    "https://vd.syncra.top/api/download",
    params={
        "url": video_url
    },
    headers={
        "Authorization": f"Bearer {api_key}"
    }
)

data = response.json()

print(data)

PHP

Use VideoFlow from a PHP backend.

PHP
<?php

$apiKey = "vf_live_YOUR_API_KEY";
$videoUrl = "https://www.tiktok.com/...";

$url = "https://vd.syncra.top/api/download?url="
     . urlencode($videoUrl);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey
]);

$response = curl_exec($ch);

curl_close($ch);

$data = json_decode($response, true);

print_r($data);

?>

n8n

Connect VideoFlow to your automation workflows without writing a full application.

1. HTTP Request

Add an HTTP Request node. Set the method to GET.

2. URL

Use:

https://vd.syncra.top/api/download

3. Query Parameter

Name: url
Value: {{ $json.url }}

4. Authorization

Add an HTTP Header:

Authorization
Bearer vf_live_YOUR_API_KEY

n8n HTTP Request
Method:
GET

URL:
https://vd.syncra.top/api/download

Query:
url = {{ $json.url }}

Header:
Authorization = Bearer vf_live_YOUR_API_KEY
After the request succeeds, the API response contains url. You can pass that URL into another HTTP Request node and download the file as binary, then send it to Telegram, WhatsApp or another service.

Errors

VideoFlow uses standard HTTP status codes.

400
Invalid or unsupported video URL.
401
Missing, invalid, inactive or expired API key.
429
Rate limit exceeded.
500
Internal server or downloader error.