Available categories

Overview

WallWidgy organizes wallpapers into categories to help you find the perfect image for your needs. Use the category query parameter to filter wallpapers by theme.

Available categories

The API currently supports these categories:

Abstract

Geometric patterns, abstract art, and non-representational designs

Amoled

Pure black backgrounds optimized for AMOLED screens

Anime

Japanese animation characters and scenes

Architecture

Buildings, structures, and architectural photography

Art

Artistic illustrations, digital art, and paintings

Cars

Vehicles, automobiles, and automotive photography

Minimal

Simple, clean designs with minimal elements

Nature

Landscapes, wildlife, plants, and natural scenery

Tech

Technology, gadgets, and futuristic themes

Basic usage

Fetch by category

curl "https://wallwidgy.com/api/wallpapers?category=anime"

Category examples

Abstract wallpapers

Geometric patterns and abstract designs:

curl "https://wallwidgy.com/api/wallpapers?category=abstract&count=5"

AMOLED wallpapers

Perfect for OLED/AMOLED displays with deep blacks:

curl "https://wallwidgy.com/api/wallpapers?category=amoled"

Anime wallpapers

Japanese animation art:

curl "https://wallwidgy.com/api/wallpapers?category=anime&count=10"

Architecture wallpapers

Buildings and structures:

curl "https://wallwidgy.com/api/wallpapers?category=architecture"

Art wallpapers

Digital art and illustrations:

curl "https://wallwidgy.com/api/wallpapers?category=art&count=3"

Car wallpapers

Vehicles and automotive photography:

curl "https://wallwidgy.com/api/wallpapers?category=cars"

Minimal wallpapers

Clean and simple designs:

curl "https://wallwidgy.com/api/wallpapers?category=minimal"

Nature wallpapers

Landscapes and natural scenery:

curl "https://wallwidgy.com/api/wallpapers?category=nature&count=5"

Tech wallpapers

Technology and futuristic themes:

curl "https://wallwidgy.com/api/wallpapers?category=tech"

Combining with other filters

Category + device type

Get mobile anime wallpapers:

curl "https://wallwidgy.com/api/wallpapers?category=anime&type=mobile"

Category + color

Get blue nature wallpapers:

curl "https://wallwidgy.com/api/wallpapers?category=nature&color=blue"

Category + color + device type

Get desktop minimal wallpapers with black color:

curl "https://wallwidgy.com/api/wallpapers?category=minimal&color=black&type=desktop"

Response format

The response includes the category in the metadata:

{
  "wallpapers": [
    "https://wallwidgy.com/wallpapers/wallpapers_abc123.webp",
    "https://wallwidgy.com/wallpapers/wallpapers_xyz789.webp"
  ],
  "count": 2,
  "category": "anime",
  "type": "all",
  "color": "all"
}

Error handling

If you request a category that doesn’t exist:

{
  "error": "Category 'fantasy' not found"
}

Category names are case-insensitive. Both anime and Anime work the same way.

Practical examples

Category selector app

const categories = [
  'abstract', 'amoled', 'anime', 'architecture',
  'art', 'cars', 'minimal', 'nature', 'tech'
];

async function fetchByCategory(category, count = 5) {
  if (!categories.includes(category.toLowerCase())) {
    throw new Error(`Invalid category: ${category}`);
  }
  
  const response = await fetch(
    `https://wallwidgy.com/api/wallpapers?category=${category}&count=${count}`
  );
  
  return await response.json();
}

// Usage
const animeWallpapers = await fetchByCategory('anime', 10);
console.log(animeWallpapers);

Random category wallpaper

import requests
import random

CATEGORIES = [
    'abstract', 'amoled', 'anime', 'architecture',
    'art', 'cars', 'minimal', 'nature', 'tech'
]

def get_random_category_wallpaper():
    """Fetch a random wallpaper from a random category"""
    category = random.choice(CATEGORIES)
    
    response = requests.get(
        'https://wallwidgy.com/api/wallpapers',
        params={'category': category, 'count': 1}
    )
    
    data = response.json()
    return {
        'category': data['category'],
        'wallpaper': data['wallpapers'][0]
    }

# Usage
result = get_random_category_wallpaper()
print(f"Random {result['category']} wallpaper: {result['wallpaper']}")

Category batch fetcher

async function fetchMultipleCategories(categories, countPerCategory = 3) {
  const promises = categories.map(category =>
    fetch(
      `https://wallwidgy.com/api/wallpapers?category=${category}&count=${countPerCategory}`
    ).then(res => res.json())
  );
  
  const results = await Promise.all(promises);
  
  return results.reduce((acc, data, index) => {
    acc[categories[index]] = data.wallpapers;
    return acc;
  }, {});
}

// Usage
const wallpapers = await fetchMultipleCategories(['anime', 'nature', 'tech'], 5);
console.log(wallpapers);
// {
//   anime: [...5 wallpapers],
//   nature: [...5 wallpapers],
//   tech: [...5 wallpapers]
// }

Category metadata

Here’s what you can expect from each category:

Category	Typical Colors	Best For	Device Type
Abstract	Varied	Creative displays	Both
AMOLED	Black, dark	Battery saving	Mobile
Anime	Vibrant, varied	Fans of Japanese animation	Both
Architecture	Gray, blue, brown	Professional look	Desktop
Art	Varied	Creative expression	Both
Cars	Red, black, silver	Automotive enthusiasts	Desktop
Minimal	White, black, gray	Clean aesthetic	Both
Nature	Green, blue, brown	Calming atmosphere	Both
Tech	Blue, cyan, black	Modern/futuristic look	Both

Best practices

Use valid categories - Check the list above for supported categories
Combine with device type - Get category wallpapers optimized for your device
Combine with colors - Narrow down results to match your theme
Request multiple wallpapers - Use count parameter to get variety

The amoled category is perfect for OLED/AMOLED displays as it features pure black backgrounds that save battery and look stunning on these screens.

Popular combinations

# Mobile AMOLED anime wallpapers
curl "https://wallwidgy.com/api/wallpapers?category=amoled&type=mobile&count=5"

# Desktop nature wallpapers with blue tones
curl "https://wallwidgy.com/api/wallpapers?category=nature&color=blue&type=desktop&count=3"

# Minimal black wallpapers
curl "https://wallwidgy.com/api/wallpapers?category=minimal&color=black&count=10"

# Tech wallpapers for mobile
curl "https://wallwidgy.com/api/wallpapers?category=tech&type=mobile&count=5"

Overview

Endpoints

Guides

​Overview