{
  "info": {
    "_postman_id": "nexwall-wallpaper-api-v1",
    "name": "NexWall Wallpaper API",
    "description": "Complete REST API collection for NexWall Category-wise 4K Wallpaper API. Supports Android, Flutter, iOS, and Web integrations.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{API_KEY}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Categories",
      "item": [
        {
          "name": "List All Categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{BASE_URL}}/categories",
              "host": ["{{BASE_URL}}"],
              "path": ["categories"]
            },
            "description": "Fetch all active wallpaper categories available on your developer plan with wallpaper counts."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Wallpapers",
      "item": [
        {
          "name": "List Wallpapers (Paginated)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{BASE_URL}}/wallpapers?per_page=20&page=1&sort=newest",
              "host": ["{{BASE_URL}}"],
              "path": ["wallpapers"],
              "query": [
                {
                  "key": "per_page",
                  "value": "20",
                  "description": "Results per page (max 100)"
                },
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number for pagination"
                },
                {
                  "key": "sort",
                  "value": "newest",
                  "description": "Sort order: newest, popular, oldest, or random"
                }
              ]
            },
            "description": "Fetch paginated wallpapers feed."
          },
          "response": []
        },
        {
          "name": "Filter Wallpapers by Category",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{BASE_URL}}/wallpapers?category_id=1&per_page=30",
              "host": ["{{BASE_URL}}"],
              "path": ["wallpapers"],
              "query": [
                {
                  "key": "category_id",
                  "value": "1",
                  "description": "Category ID obtained from /categories"
                },
                {
                  "key": "per_page",
                  "value": "30"
                }
              ]
            },
            "description": "Filter wallpapers by a specific category ID."
          },
          "response": []
        },
        {
          "name": "Search Wallpapers by Tags / Keywords",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{BASE_URL}}/wallpapers?search=dark&per_page=20",
              "host": ["{{BASE_URL}}"],
              "path": ["wallpapers"],
              "query": [
                {
                  "key": "search",
                  "value": "dark",
                  "description": "Search keyword or tag (minimum 2 characters)"
                },
                {
                  "key": "per_page",
                  "value": "20"
                }
              ]
            },
            "description": "Search wallpapers using keywords or tag matches."
          },
          "response": []
        },
        {
          "name": "Get Single Wallpaper Details",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{BASE_URL}}/wallpapers/1",
              "host": ["{{BASE_URL}}"],
              "path": ["wallpapers", "1"]
            },
            "description": "Fetch full metadata for a single wallpaper by its ID."
          },
          "response": []
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "BASE_URL",
      "value": "https://nexwall.kodnextech.com/api/developer/v1",
      "type": "string"
    },
    {
      "key": "API_KEY",
      "value": "YOUR_DEVELOPER_API_KEY_HERE",
      "type": "string"
    }
  ]
}