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. Cannot be used with the "recent" tag.
  • tag (optional): Filter wallpapers by tag. Accepted values: "desktop", "mobile", or "recent".
  • 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=4kGET https://www.wallwidgy.me/api/random-wallpapers?tag=recent&resolution=1080p

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

Wallpapers by Date API

This API allows you to fetch wallpapers uploaded on a specific date. You can specify the date in the format DD/MM/YYYY.

Endpoint

GET https://www.wallwidgy.me/api/date

Query Parameters

  • date (required): The date to filter wallpapers by, in the format DD/MM/YYYY.

Example Usage

GET https://www.wallwidgy.me/api/date?date=16/01/2025

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