API Endpoints

Complete reference for all available API endpoints.

List Wallpapers

GET /v1/wallpapers

Returns a paginated list of wallpapers.

Query Parameters

Parameter Type Description
page integer Page number (default: 1)
per_page integer Items per page (default: 20, max: 100)
category string Filter by category
resolution string Filter by resolution (e.g., "1920x1080")

Example Request

curl -X GET "https://api.wallaza.com/v1/wallpapers?page=1&per_page=20" \
     -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
    "data": [
        {
            "id": 1,
            "title": "Mountain Landscape",
            "description": "Beautiful mountain landscape at sunset",
            "url": "https://wallaza.com/wallpapers/mountain-landscape.jpg",
            "thumbnail": "https://wallaza.com/thumbnails/mountain-landscape.jpg",
            "resolution": "1920x1080",
            "category": "Nature",
            "downloads": 1234,
            "created_at": "2023-01-01T00:00:00Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 20,
        "total_items": 100,
        "total_pages": 5
    }
}

Get Single Wallpaper

GET /v1/wallpapers/{id}

Returns detailed information about a specific wallpaper.

Path Parameters

Parameter Type Description
id integer Unique identifier of the wallpaper

Example Request

curl -X GET "https://api.wallaza.com/v1/wallpapers/1" \
     -H "Authorization: Bearer YOUR_API_KEY"

Search Wallpapers

GET /v1/search

Search wallpapers by keywords.

Query Parameters

Parameter Type Description
q string Search query
page integer Page number (default: 1)

Example Request

curl -X GET "https://api.wallaza.com/v1/search?q=mountain&page=1" \
     -H "Authorization: Bearer YOUR_API_KEY"