API DOCUMENTATION

Complete reference for Blaze API

REST API | Version 1.0.0
5+
Platforms Supported
No Rate Limits
10min
Temp Storage
Free
No API Keys

Base URL

http://localhost:3000
All endpoints are relative to this base URL. No authentication required.

Features

No Rate Limits

Make unlimited requests

No API Keys

Free for everyone

10-Min Storage

Auto-delete temp files

CORS Enabled

Use from any domain

Endpoints

GET /api/download

Download media from Facebook, Instagram, TikTok, Twitter/X, or YouTube.

Query Parameters

ParameterTypeRequiredDescription
urlstring✓ YesDirect URL to the media (Facebook, Instagram, TikTok, Twitter, YouTube)

Example Request

GET /api/download?url=https://www.tiktok.com/@user/video/123456789

Example Response

{
  "success": true,
  "data": {
    "thumbnailUrl": "https://...",
    "tempDownloadUrl": "/temp/video_123456789.mp4",
    "title": "Amazing TikTok Video",
    "platform": "tiktok",
    "duration": "15",
    "expiresIn": "10 minutes",
    "tempUrl": "/temp/video_123456789.mp4"
  }
}
GET /api/song

Search and download audio from YouTube.

Query Parameters

ParameterTypeRequiredDescription
qstringYes*Song name or artist to search
urlstringYes*Direct YouTube URL
Provide either q OR url

Example Requests

GET /api/song?q=Blinding Lights The Weeknd
GET /api/song?url=https://youtu.be/4NRXx6U8ABQ

Example Response

{
  "success": true,
  "data": {
    "thumbnailUrl": "https://...",
    "tempDownloadUrl": "/temp/song_123456789.mp3",
    "title": "Blinding Lights",
    "artist": "The Weeknd",
    "duration": "3:20",
    "quality": "128kbps",
    "expiresIn": "10 minutes"
  }
}
GET /status

Check API health and status.

Example Response

{
  "status": "online",
  "system": "Blaze API",
  "version": "1.0.0",
  "uptime": 1234.56,
  "tempFiles": 3
}

Temp File Access

GET /temp/{filename}

Download temporary files directly.

Files are automatically deleted after 10 minutes from creation.

Example

GET /temp/video_1734567890.mp4

Supported Platforms

PlatformEndpointFormatCommand
YouTube/api/download + /api/songMP4 / MP3`.yt ` or song search
TikTok/api/downloadMP4 (No watermark)`.tt `
Instagram/api/downloadMP4 / JPG`.ig `
Facebook/api/downloadMP4`.fb `
Twitter/X/api/downloadMP4 / JPG`.tw `
Spotify/api/songMP3`.sp `

Error Responses

{
  "success": false,
  "error": "Error message description"
}
HTTP CodeDescription
400Bad Request - Missing or invalid parameters
404Not Found - Endpoint or file not found
500Internal Server Error - Download failed

Code Examples

cURL

curl "http://localhost:3000/api/download?url=https://www.tiktok.com/@user/video/123"

JavaScript (Fetch)

fetch('http://localhost:3000/api/song?q=Bohemian Rhapsody')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Python

import requests
response = requests.get('http://localhost:3000/api/download', 
                       params={'url': 'https://youtu.be/dQw4w9WgXcQ'})
data = response.json()
print(data)

Node.js (Axios)

const axios = require('axios');
const response = await axios.get('http://localhost:3000/api/song', {
  params: { q: 'Shape of You' }
});
console.log(response.data);

Rate Limits

No rate limits! You can make unlimited requests. However, please be respectful of server resources.