API Documentation

Random Wallpapers API

This API allows you to fetch random wallpapers from our collection. You can specify the number of wallpapers, filter by tag, and set a specific resolution for the wallpapers.

Endpoint

GET https://www.wallwidgy.me/api/random-wallpapers

Query Parameters

  • count (optional): Number of wallpapers to return. Default is 1.
  • tag (optional): Filter wallpapers by tag. Accepted values: "desktop" or "mobile".
  • resolution (optional): Filter wallpapers by resolution. Accepted values: "1080p", "1440p", "4k", "8k".

Example Usage

GET https://www.wallwidgy.me/api/random-wallpapers?count=3&tag=desktop&resolution=4k

Response

The API returns an array of wallpaper objects with the following properties:

  • public_id: Unique identifier for the wallpaper
  • name: Filename of the wallpaper
  • width: Width of the wallpaper
  • height: Height of the wallpaper
  • format: File format of the wallpaper
  • created_at: Creation date of the wallpaper
  • tags: Array of tags associated with the wallpaper
  • colors: Array of colors present in the wallpaper
  • preview_url: URL for the preview image
  • download_url: URL for downloading the full-resolution wallpaper