50+ Categories • Full-Text Search • Sorting & Pagination

Wallpaper REST API Features & Endpoints

Direct Answer • Feature Summary

NexWall Wallpaper REST API provides an extensive feature set for mobile apps: 50+ organized categories with cover images, keyword search, flexible sorting (popular, newest, random), pagination controls (up to 50 items/page), dual WebP/4K original image URLs, and dedicated live MP4 video wallpaper filtering.

Get Free API Key Full Interactive Docs

Primary API Endpoints

All endpoints are served over secure HTTPS and authenticate via standard Sanctum Bearer tokens.

GET /api/developer/v1/categories
Returns 50+ categories with count & cover images 
{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "AMOLED & Dark",
      "slug": "amoled-dark",
      "cover_image_url": "https://nexwall.kodnextech.com/storage/categories/amoled.webp",
      "wallpaper_count": 340,
      "is_premium": false
    },
    {
      "id": 2,
      "name": "Anime & Manga",
      "slug": "anime-manga",
      "cover_image_url": "https://nexwall.kodnextech.com/storage/categories/anime.webp",
      "wallpaper_count": 612,
      "is_premium": false
    }
  ]
}
GET /api/developer/v1/wallpapers
Supports category_id, search, sort, type & pagination
// Query parameters supported:
?category_id=5 — Filter by specific category
?search=cyberpunk — Search tags and keywords
?sort=popular|newest|random — Sort ordering
?type=image|live — Filter static or live video wallpapers
?per_page=20 — Items per page (default 20, max 50)
?page=2 — Pagination page index

Feature & Endpoint FAQs

What is the rate limit on the NexWall Wallpaper API?

Free plans include 100 requests per day. The Pro plan provides 10,000 requests per day, and the Ultra plan delivers 50,000 requests per day with live wallpaper support.

Are rate limit headers included in every API response?

Yes. Every response contains X-RateLimit-Limit, X-RateLimit-Remaining, and X-NexWall-Latency-Ms headers so your client can monitor usage programmatically.

How fast does the search query execute?

Indexed tag queries and caching keep typical search queries fast, though response times are not guaranteed.

Can I filter for only free wallpapers?

Yes, the is_premium boolean attribute on each wallpaper allows client apps to easily separate free wallpapers from premium ad-locked content.

Integrate Wallpaper API Endpoints

Start with 100 free requests per day. Access 50+ categories, 4K wallpapers, and live video feeds in minutes.

Get Free API Key Explore API Docs