API Documentation

📋 API Overview

The AnonMP4 API provides programmatic access to upload, manage, and stream video content. All API endpoints return JSON responses and support modern HTTP methods.

Base URL

https://anonmp4api.xyz/

Content Types

Request: multipart/form-data (for uploads), application/json (for data)
Response: application/json

Key API Features

Upload videos up to 20GB in size
Support for all major video formats (MP4, AVI, MKV, MOV, etc.)
Multiple privacy levels (public, unlisted, password-protected)
Multi-audio streaming supported - multiple audio tracks for different languages
No account registration required - completely anonymous uploads

🔐 Authentication

Currently, the API does not require authentication for basic operations. All uploads are anonymous by default.

Anonymous Usage

No registration or API keys required. Simply make HTTP requests to the endpoints listed below.

📤 Upload Video

Upload a video file directly to the platform with optional metadata and privacy settings.

POST

https://anonmp4api.xyz/upload

Request Parameters

Parameter	Type	Required	Description
`file`	file	Required	Video file (max 20GB, video/* mime types)
`title`	string	Optional	Video title (defaults to filename)
`privacy`	string	Optional	Privacy level: `public`, `unlisted`, or `password` (default: public)
`password`	string	Optional	Password for protected videos (required if privacy=password)

Example Request

cURL

JavaScript

Python

PHP

Node.js

Go

curl -X POST "https://anonmp4api.xyz/upload" \
  -F "file=@/path/to/video.mp4" \
  -F "title=My Awesome Video" \
  -F "privacy=public"

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('title', 'My Awesome Video');
formData.append('privacy', 'public');

fetch('https://anonmp4api.xyz/upload', {
    method: 'POST',
    body: formData
})
.then(response => response.json())
.then(data => console.log(data));

import requests

files = {'file': open('video.mp4', 'rb')}
data = {
    'title': 'My Awesome Video',
    'privacy': 'public'
}

response = requests.post('https://anonmp4api.xyz/upload', 
                        files=files, data=data)
print(response.json())

<?php
$url = 'https://anonmp4api.xyz/upload';
$file = new CURLFile('/path/to/video.mp4');

$data = [
    'file' => $file,
    'title' => 'My Awesome Video',
    'privacy' => 'public'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch');

const form = new FormData();
form.append('file', fs.createReadStream('/path/to/video.mp4'));
form.append('title', 'My Awesome Video');
form.append('privacy', 'public');

fetch('https://anonmp4api.xyz/upload', {
    method: 'POST',
    body: form
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

func main() {
    file, err := os.Open("/path/to/video.mp4")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    var b bytes.Buffer
    writer := multipart.NewWriter(&b)
    
    fw, err := writer.CreateFormFile("file", "video.mp4")
    if err != nil {
        panic(err)
    }
    
    io.Copy(fw, file)
    writer.WriteField("title", "My Awesome Video")
    writer.WriteField("privacy", "public")
    writer.Close()

    req, err := http.NewRequest("POST", "https://anonmp4api.xyz/upload", &b)
    if err != nil {
        panic(err)
    }
    
    req.Header.Set("Content-Type", writer.FormDataContentType())
    
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    
    fmt.Println(resp.Status)
}

Success Response

{
  "success": true,
  "video_id": "NLEusIzEvLs3s3B",
  "title": "BigBuckBunny",
  "thumbnail": "https://red-truth-1e89.ceres54.workers.dev/z9HR0x7HM6Lb59k4w6r15e8z92Np9y8r15b5w6S92z9WRo8y81Bb5ZXZk4ZXx7_z9WQ9ODt3b5Mq0Ea4MTMb5OTx74OCZ0v5XBo8PTM3Jn7o8p9v5D0c6NSZ0z9249Vq0NTNU5z9Yo8VUTq0NYNn75ESVo8p9z9Ug00Q0RLTU00Jn7Zf9PWV4w6GVb5y8n7Fh1Xa4t3/NLEusIzEvLs3s3B_hd.webp",
  "watch_url": "https://anonmp4.to/v/NLEusIzEvLs3s3B",
  "embed_url": "https://anonmp4.to/embed/NLEusIzEvLs3s3B",
  "delete_url": "https://anonmp4.to/delete?id=NLEusIzEvLs3s3B&hash=uniqehash",
  "upload_date": "2026-01-08T10:30:00Z",
  "message": "File received and queued for processing"
}

📹 Get Video Information

Retrieve detailed information about a specific video including metadata, streaming URLs, and download options.

GET

/info/{video_id}

URL Parameters

Parameter	Type	Description
`video_id`	string	Unique video identifier

Example Request

cURL

JavaScript

PHP

Node.js

curl -X GET "https://anonmp4api.xyz/info/NLEusIzEvLs3s3B"

fetch('https://anonmp4api.xyz/info/NLEusIzEvLs3s3B')
  .then(response => response.json())
  .then(data => console.log(data));

<?php
$videoId = 'NLEusIzEvLs3s3B';
$url = 'https://anonmp4api.xyz/info/' . $videoId;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

const fetch = require('node-fetch');

const videoId = 'NLEusIzEvLs3s3B';
const url = `https://anonmp4api.xyz/info/${videoId}`;

fetch(url)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Success Response

{
    "success": true,
    "title": "BigBuckBunny",
    "duration": "09:56",
    "watch_url": "https://anonmp4.to/v/8N5dnc8bmwGxTQT",
    "embed_url": "https://anonmp4.to/embed/8N5dnc8bmwGxTQT",
    "thumbnail": "https://red-truth-1e89.ceres54.workers.dev/z9HR0x7HM6Lb59k4w6r15e8z92Np9y8r15b5w6S92z9WRo8y81Bb5ZXZk4ZXx7_z9WQ9ODt3b5Mq0Ea4MTMb5OTx74OCZ0v5XBo8PTM3Jn7o8p9v5D0c6NSZ0z9249Vq0NTNU5z9Yo8VUTq0NYNn75ESVo8p9z9Ug00Q0RLTU00Jn7Zf9PWV4w6GVb5y8n7Fh1Xa4t3/NLEusIzEvLs3s3B_hd.webp",
    "upload_date": "2025-12-28 18:01:38",
    "privacy_type": "public",
    "status": "active"
}

⚠️ Error Codes

The API uses conventional HTTP response codes and returns detailed error information in JSON format.

HTTP Status Codes

Status Code	Meaning
`200`	Success
`400`	Bad Request - Invalid parameters
`404`	Not Found - Video does not exist
`413`	Payload Too Large - File exceeds size limit
`415`	Unsupported Media Type - Invalid file format
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error

API Error Codes

Error Code	Description
`E_NO_FILE`	No file provided in upload request
`E_INVALID_SIZE`	File size exceeds 20GB limit
`E_INVALID_TYPE`	File is not a supported video format
`E_INVALID_PRIVACY`	Invalid privacy value provided
`E_PASSWORD_REQUIRED`	Password required for password-protected videos
`E_UPLOAD_FAILED`	Upload processing failed
`E_HANDLER_FAILED`	Upload handler failed
`E_VIDEO_NOT_FOUND`	Requested video does not exist

Error Response Format

{
  "success": false,
  "error": {
    "code": "E_INVALID_SIZE",
    "message": "File size exceeds the 20GB limit",
    "details": {
      "max_size": 53687091200,
      "received_size": 107374182400
    }
  }
}

🚀 API Documentation

📋 API Overview

Base URL

Content Types

Key API Features

🔐 Authentication

Anonymous Usage

📤 Upload Video

Request Parameters

Example Request

Success Response

📹 Get Video Information

URL Parameters

Example Request

Success Response

⚠️ Error Codes

HTTP Status Codes

API Error Codes

Error Response Format