Developer Platform

API Documentation

Integrate high-quality minimalistic wallpapers into your applications with our fast, public, and lightweight API.

Base URL

https://wallpapers.platform/api/v1

Response Time

< 50ms

Total Assets

330+

Authentication

Our API is 100% public. No API keys, registration, or tokens required. Simply make a request to our endpoints and get started immediately.

Response Types

JSON Metadata

Most endpoints return structured JSON metadata including image URLs, author information, and unique identifiers.

Raw Image Stream

Use our /image endpoints to get a direct binary stream or redirect to the image file, perfect for src attributes.

GET

/api/v1/random

Retrieve a random high-quality minimalist wallpaper metadata.

fetch("https://wallpapers.platform/api/v1/random")
  .then(res => res.json())
  .then(console.log);

Example Response

{
  "id": "alena-aenami-horizon",
  "url": "/images/alena-aenami-horizon.png",
  "filename": "alena-aenami-horizon.png",
  "author": "Alena Aenami",
  "title": "Horizon"
}

GET

/api/v1/random/image

Directly get a random wallpaper image file. Great for <img> tags.

// Use directly in your HTML
const img = new Image();
img.src = "https://wallpapers.platform/api/v1/random/image";
document.body.appendChild(img);

Example Response

Content-Type: image/png
Status: 200 OK

[Binary Image Data]

GET

/api/v1/images

List all wallpapers with built-in pagination support.

Query Parameters

Parameter	Type	Default	Description
limit	number	20	Maximum number of images to return.
offset	number	0	Number of images to skip.

fetch("https://wallpapers.platform/api/v1/images")
  .then(res => res.json())
  .then(console.log);

Example Response

{
  "total": 337,
  "limit": 2,
  "offset": 0,
  "images": [
    {
      "id": "acoolrocket-dalle2-hokusai",
      "title": "Hokusai",
      "author": "Acoolrocket",
      "url": "/images/..."
    },
    {
      "id": "afreen-red-sunset",
      "title": "Red Sunset",
      "author": "Afreen",
      "url": "/images/..."
    }
  ]
}

GET

/api/v1/image/:id/raw

Get a specific wallpaper directly as an image file using its ID.

// Use directly in your HTML
const img = new Image();
img.src = "https://wallpapers.platform/api/v1/image/:id/raw";
document.body.appendChild(img);

Example Response

Content-Type: image/png
Status: 200 OK

[Binary Image Data]

GET

/api/v1/search

Powerful search across titles and artist names.

Query Parameters

Parameter	Type	Default	Description
q	string	—	The search query (case-insensitive).

fetch("https://wallpapers.platform/api/v1/search")
  .then(res => res.json())
  .then(console.log);

Example Response

{
  "count": 12,
  "results": [
    {
      "id": "sunset-1",
      "title": "Purple Sunset",
      "author": "Artist",
      "url": "/images/..."
    }
  ]
}

GET

/api/v1/tags

Get a list of available categories and tags.

fetch("https://wallpapers.platform/api/v1/tags")
  .then(res => res.json())
  .then(console.log);

Example Response

{
  "count": 10,
  "tags": [
    "Nature",
    "Minimalist",
    "Flat Art",
    "Landscape"
  ]
}

Rate Limiting

To ensure high availability for everyone, we apply soft rate limiting on public endpoints. Limits are based on IP address and are generous for standard usage.

Public Tier

Standard for all public requests.

Requests1,000 / day

Burst10 / sec