Image Hosting API
For Developers

Build with a free image hosting API that returns permanent direct URLs. No API keys, no signup, no cost, just upload and get JSON with your links.

A Simple Upload API for Any Project

PixelHost exposes a straightforward HTTP upload endpoint that any language can call, JavaScript, Python, PHP, Go, or cURL. You POST your image file and receive a JSON response with the permanent direct URL, BBCode, Markdown, and HTML embed. This makes it perfect for chat bots, forum plugins, CMS editors, screenshot tools, and any app that needs quick image hosting.

Example: Upload via cURL

Send a single image with the files field. You get JSON back with all your links ready to use.

Single file upload
bash
curl -X POST https://www.pixelhost.fun/api/upload \
  -F "files=@screenshot.png"
JSON response
json
{
  "success": true,
  "url": "https://www.pixelhost.fun/uploads/2026/08/screenshot-...png",
  "filename": "screenshot-1785576873370.png",
  "originalName": "screenshot.png",
  "alt": "screenshot",
  "direct": "https://www.pixelhost.fun/uploads/2026/08/screenshot-...png",
  "html": "<a href="https://www.pixelhost.fun/" target="_blank"><img src="https://www.pixelhost.fun/uploads/2026/08/screenshot-...png" alt="screenshot" loading="lazy" width="800" height="600"></a>",
  "bbcode": "[url=https://www.pixelhost.fun/][img]https://www.pixelhost.fun/uploads/2026/08/screenshot-...png[/img][/url]",
  "markdown": "[![screenshot](https://www.pixelhost.fun/uploads/2026/08/screenshot-...png)](https://www.pixelhost.fun/)",
  "cdn": "https://www.pixelhost.fun/cdn/2026/08/screenshot-...png"
}

Multiple Files in One Request

Repeat the files field to upload several images at once. They are processed in parallel and each gets its own permanent links.

Batch upload
bash
curl -X POST https://www.pixelhost.fun/api/upload \
  -F "files=@shot1.png" \
  -F "files=@shot2.jpg" \
  -F "files=@shot3.gif"

Why Use the PixelHost API?

Completely Free

No pricing tiers, no rate limits, no mandatory API keys. Just POST and get links.

Parallel Uploads

Send multiple files in one request, they upload in parallel and return together.

All Major Formats

JPG, PNG, GIF, WEBP, and AVIF are handled automatically. No conversion setup needed.

Links Never Expire

Images are stored permanently. Your direct URLs keep working forever.

Reliable for Production Workloads

Images are stored on Supabase object storage with a global CDN front-end, so links load fast everywhere. The uploader processes files in parallel, skips recompression when it would slow you down, and always keeps your original file. Whether you are building a microservice or a weekend side project, the PixelHost API gets your images online with minimal code.

Frequently Asked Questions

Is there a free image upload API?

Yes, PixelHost provides a free image upload API. POST your image to https://www.pixelhost.fun/api/upload and get back permanent direct URLs, BBCode, Markdown, and HTML embeds in JSON.

Do I need an API key?

No API key is required. The upload endpoint is open and free, so you can start uploading immediately from any application.

What formats and sizes does the API accept?

The API accepts JPG, PNG, GIF, WEBP, and AVIF files up to 4MB each, and supports uploading up to 20 files in one request.

Are API uploads permanent?

Yes, images uploaded through the API are stored permanently and the returned links never expire.

Can I use the API for a bot or plugin?

Absolutely. The API returns ready-to-use BBCode and Markdown, making it ideal for Discord bots, forum plugins, CMS editors, and screenshot tools.