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