Vanilla Downloader API Docs

Complete documentation for the Vanilla Downloader API. Learn how to download TikTok videos, manage API keys, and integrate with your application.

Introduction

Vanilla Downloader provides a powerful REST API for downloading TikTok videos and audio without watermarks. Our API is fast, reliable, and easy to integrate.

Fast

Response time under 2 seconds

🔒
Secure

API key authentication

🌐
Global

CDN-powered delivery

Quick Start

Get started in 3 simple steps:

  1. Get your API key from the Admin Panel
  2. Make a request to our download endpoint
  3. Get the video URL and download
cURL
curl "https://vanilla-downloader.vercel.app/api/download?url=https://www.tiktok.com/@user/video/1234567890"

Installation

Clone the repository and deploy to Vercel:

Bash
git clone https://github.com/your-repo/vanilla-downloader.git
cd vanilla-downloader
npm install
vercel deploy

Download API

GET /api/download?url={tiktok_url}

Parameters

ParamTypeRequiredDescription
urlstringYesTikTok video URL

Response

JSON
{
  "code": 0,
  "msg": "success",
  "data": {
    "id": "1234567890",
    "title": "Video Title",
    "cover": "https://...",
    "origin_cover": "https://...",
    "play": "https://...",
    "wmplay": "https://...",
    "hdplay": "https://...",
    "music": "https://...",
    "duration": 30,
    "author": {
      "id": "123",
      "unique_id": "user",
      "nickname": "Username"
    },
    "play_count": 100000,
    "digg_count": 5000,
    "comment_count": 200,
    "share_count": 100
  }
}

Proxy Download

GET /api/proxy-download?url={video_url}

Proxies the video download through our server to avoid CORS and CDN redirect issues.

Chat API

GET /api/chat?room_id={room_id}
POST /api/chat

Send and receive chat messages between admin and buyers.

API Keys

Manage your API keys through the admin panel. Each key has a rate limit and usage tracking.

GET /api/keys
POST /api/keys

Orders API

View and manage customer orders and subscriptions.

GET /api/orders

Stats API

Get download statistics and analytics data.

GET /api/stats

Authentication

Include your API key in the X-API-Key header for protected endpoints:

cURL
curl -H "X-API-Key: your_api_key_here" \
  "https://vanilla-downloader.vercel.app/api/stats"

Rate Limiting

PlanRequests/HourDownloads/Day
Free10010
Pro1000Unlimited
EnterpriseUnlimitedUnlimited

Error Codes

CodeDescription
0Success
-1Invalid URL
401Unauthorized
429Rate limit exceeded
500Server error

Webhooks

Configure webhooks in the admin panel to receive real-time notifications about downloads and events.

Deploy to Vercel

  1. Fork or clone the repository
  2. Import to Vercel dashboard
  3. No environment variables needed (in-memory DB)
  4. Deploy and your API is live!

Configuration

The application uses vercel.json for routing and db.js for in-memory storage.

Environment Variables

VariableRequiredDefault
ADMIN_EMAILNof50489341@gmail.com
ADMIN_PASSWORDNovanilla2024