Edge Active • Fast, Free & Resilient Media Hosting

AR Hosting API Documentation

Developer reference for high-performance media storage powered by Cloudflare Workers and Telegram edge backends. Upload images, videos, audio, and documents with zero database overhead.

Global Delivery Edge Caching • Fast CDN
Storage Backend Telegram Cloud Storage
Maximum File Size 20 MB Per Upload

Quick Start

Send a direct multipart file upload with POST /upload.

Instant Global Edge

Upload and retrieve your media files in milliseconds across Cloudflare's 300+ edge locations.

Resilient Storage

All assets are distributed across Telegram cloud backends with durable Base32 hash references.

Telegram Bot

Upload directly from any device or channel via our official Telegram bot integration.

cURL Direct Upload Example
POST /upload
curl -X POST https://ar-hosting.pages.dev/upload \
  -H "Content-Type: multipart/form-data" \
  -F "file=@path/to/your/file.jpg"

API Endpoints

Base URL: https://ar-hosting.pages.dev

POST /upload
Direct multipart upload

Uploads any media file (image, video, audio, document) directly via multipart/form-data. Ideal for client-side forms and backend integrations.

Header
Content-Type: multipart/form-data Required
Form Data Parameters
Parameter Type Required Description
file File binary Required The media file to upload (image, video, audio, doc). Maximum file size is 20 MB.
JavaScript • Modern Fetch API
JavaScript (Browser / Node)
const fileInput = document.querySelector('input[type="file"]');
const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch('https://ar-hosting.pages.dev/upload', {
  method: 'POST',
  body: formData
});
const data = await response.json();
console.log('Hosted URL:', data.url);
Python • Requests Library
Python 3
import requests

url = "https://ar-hosting.pages.dev/upload"
with open("sample.jpg", "rb") as f:
    files = {"file": f}
    res = requests.post(url, files=files)
    print(res.json())
GET /hosturl?url=[media_url]
Remote URL import

Streams and uploads media from any publicly accessible URL directly to AR Hosting without downloading it locally.

Query Parameters
Parameter Type Required Description
url string (URI) Required The URL of the remote media to download and store (up to 20 MB).
Example Request
HTTP Request
https://ar-hosting.pages.dev/hosturl?url=https://images.unsplash.com/photo-1579546929518-9e396f3cc809
GET /f/:hash
Resilient file streaming

Serves the media asset directly via self-contained Base32 payload encoding. Edge workers decode the embedded routing parameters on-the-fly and stream the binary stream with full edge caching.

Direct File Link Example
Direct Link
https://ar-hosting.pages.dev/f/K55HSQJYLBJEO5KGGFTWCZTBONASVTZTCLANX3RKBGMMNNA

Response Formats

Consistent, predictable JSON structures for all requests.

Success Response (200 OK)
{
  "data": "https://ar-hosting.pages.dev/f/K55HSQJYLBJEO5KGGFTWCZTBONASVTZTCLANX3RKBGMMNNA",
  "url": "https://ar-hosting.pages.dev/f/K55HSQJYLBJEO5KGGFTWCZTBONASVTZTCLANX3RKBGMMNNA",
  "filename": "qGZcyzxn.jpg",
  "size": 128453,
  "uploaded_on": "2026-10-03T14:54:51.091Z",
  "media_type": "image/jpeg",
  "creator": "https://t.me/Ashlynn_Repository"
}
JSON Key Type Description
data string Direct URL of the hosted media file.
url string Alias for data for broad integration compatibility.
filename string Original or sanitized filename of the uploaded file.
size number Exact file size measured in bytes.
uploaded_on string (ISO 8601) Server UTC timestamp when the upload was registered.
media_type string MIME type detected from the file headers.
creator string (URL) Credit link to Ashlynn Repository project maintainer.
Error Response Format
{
  "error": "File size exceeds maximum allowed 20MB limit"
}
HTTP Status Codes
Status Code Condition
200 OK Media uploaded and hosted successfully.
400 Bad Request Missing file parameter, invalid remote URL, or empty payload.
404 Not Found File does not exist or URL hash cannot be decoded.
413 Payload Too Large File size exceeds the 20 MB ceiling.
500 Internal Error Telegram edge communication issue or upstream timeout.

Direct File Formats

Native support for JPG, PNG, GIF, WebP, MP4, MOV, WebM, MP3, WAV, PDF, TXT, and ZIP archives.

Zero Database Overhead

State-of-the-art Base32 hash addressing removes single-point-of-failure database dependencies.

Edge Caching

Cloudflare Workers edge cache stores warm assets globally for instant, high-speed delivery.

Zero-code workflow

Telegram Bot Integration

Upload files on the go directly inside Telegram using @AR_UrlUploaderBot.

Launch Bot
Step-by-Step Bot Usage

1. Start Bot

Open Telegram and start @AR_UrlUploaderBot.

2. Send Media

Send any photo, video, document, or paste a public web link in the chat.

3. Instant Link

Receive your permanent AR Hosting CDN URL immediately.

Supported Bot Commands
Command Action
/start Initializes the bot and displays the interactive welcome menu.
/help Shows supported file types, limits, and advanced upload instructions.

About AR Hosting

Speed, security, and resilience at edge scale.

AR Hosting provides ultra-fast, resilient image, video, and general media hosting. Built on Cloudflare Workers edge nodes and resilient Telegram cloud storage, our platform delivers high availability without database friction.

Maintained by Ashlynn Repository

Ashlynn Repository is maintained by Aarabh (known as itz_ashlynn), specializing in Telegram bot ecosystems, edge APIs, and cloud services. Discover our open-source tools on our official Telegram Channel.

Disclaimer

AR Hosting is an independent service created for educational and utility purposes and is not affiliated with or endorsed by Telegram or Cloudflare. Users are solely responsible for compliance with applicable laws and copyright regulations regarding uploaded content.