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.
Response time under 2 seconds
API key authentication
CDN-powered delivery
Quick Start
Get started in 3 simple steps:
- Get your API key from the Admin Panel
- Make a request to our download endpoint
- Get the video URL and download
curl "https://vanilla-downloader.vercel.app/api/download?url=https://www.tiktok.com/@user/video/1234567890"
Installation
Clone the repository and deploy to Vercel:
git clone https://github.com/your-repo/vanilla-downloader.git cd vanilla-downloader npm install vercel deploy
Download API
/api/download?url={tiktok_url}
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
url | string | Yes | TikTok video URL |
Response
{
"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
/api/proxy-download?url={video_url}
Proxies the video download through our server to avoid CORS and CDN redirect issues.
Chat API
/api/chat?room_id={room_id}
/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.
/api/keys
/api/keys
Orders API
View and manage customer orders and subscriptions.
/api/orders
Stats API
Get download statistics and analytics data.
/api/stats
Authentication
Include your API key in the X-API-Key header for protected endpoints:
curl -H "X-API-Key: your_api_key_here" \ "https://vanilla-downloader.vercel.app/api/stats"
Rate Limiting
| Plan | Requests/Hour | Downloads/Day |
|---|---|---|
| Free | 100 | 10 |
| Pro | 1000 | Unlimited |
| Enterprise | Unlimited | Unlimited |
Error Codes
| Code | Description |
|---|---|
0 | Success |
-1 | Invalid URL |
401 | Unauthorized |
429 | Rate limit exceeded |
500 | Server error |
Webhooks
Configure webhooks in the admin panel to receive real-time notifications about downloads and events.
Deploy to Vercel
- Fork or clone the repository
- Import to Vercel dashboard
- No environment variables needed (in-memory DB)
- Deploy and your API is live!
Configuration
The application uses vercel.json for routing and db.js for in-memory storage.
Environment Variables
| Variable | Required | Default |
|---|---|---|
ADMIN_EMAIL | No | f50489341@gmail.com |
ADMIN_PASSWORD | No | vanilla2024 |