Android App REST API v1.0

HD Wallpapers Hub - API Console

Complete RESTful endpoints for Android Wallpaper App with ready-to-test interactive requests, pagination, and JSON responses.

GET /api/categories.php
Categories List

Fetch all active wallpaper categories with total wallpaper count and cover thumbnail image URLs.

Query Parameters:
  • page (optional, int): Page number (default: 1)
  • limit (optional, int): Items per page (default: 20)
  • sort (optional, string): order (default), name, popular, latest
// Click "Send Request" to fetch live response
GET /api/wallpapers.php
Wallpapers Feed

Fetch wallpapers with category filtering, latest/popular/random sorting, and pagination.

Query Parameters:
  • category_id (optional, int): Filter by category ID
  • type (optional, string): latest, popular, featured, random, premium
  • tag (optional, string): Filter by tag name or slug (e.g. amoled, 4k)
  • page (optional, int): Page number (default: 1)
  • limit (optional, int): Items per page (default: 20)
// Click "Send Request" to fetch live response
GET /api/wallpaper_details.php
Details & Related

Fetch detailed wallpaper metadata (dimensions, 4K resolution tag, full file size, tags) plus 6 related wallpapers.

Query Parameters:
  • id (required, int): Wallpaper ID
// Click "Send Request" to fetch live response
GET /api/sliders.php
Home Banner Sliders

Fetch active home banner sliders for carousel in the Android app home screen.

// Click "Send Request" to fetch live response
POST /api/update_view.php
Update View Count

Increment the view impressions counter when a user opens a wallpaper in the Android app.

// Click "Send Request" to fetch live response
POST /api/update_download.php
Update Download Count

Increment the download counter when a user saves or sets a wallpaper.

// Click "Send Request" to fetch live response
GET /api/settings.php
App & Ads Config

Fetch remote app config, AdMob banner/interstitial/rewarded ad unit IDs, and OneSignal keys.

// Click "Send Request" to fetch live response
POST /api/upload.php
Single & Multiple Upload

Upload a single wallpaper or multiple wallpapers at once with automatic HD thumbnail generation (480px width) and dimensions/resolution detection.

Form Data (multipart/form-data):
  • category_id (required, int): Target Category ID (e.g. 1)
  • images[] or image (required, file/files): Upload single or multiple files (JPG, PNG, WEBP)
  • title (optional, string): Custom title (auto-generated from filename if empty or multiple)
  • tags (optional, string): Comma-separated tags (e.g. anime, 4k, amoled)
  • is_featured (optional, int): 1 for featured, 0 for standard (default: 0)
// Example cURL for Multiple Upload:
curl -X POST https://www.wall.funapptech.com/api/upload.php \
  -F "category_id=1" \
  -F "tags=anime,4k,dark" \
  -F "images[]=@wallpaper1.jpg" \
  -F "images[]=@wallpaper2.png"