Lazytextures Public API

Introduction

The Lazytextures API gives you programmatic access to the full asset library. All assets are CC0 — completely free to use in any project, commercial or personal, with no attribution required.

No API key or authentication required for any public endpoint.
All responses are JSON.
Asset file paths returned by the API can be used directly to download files.
The API is used by Lazybridge to power the in-app asset browser.

Base URL & Format

Base URL https://lazytextures.net:3000

Response Envelope

Every endpoint returns a JSON object. Successful responses always include success: true and a timestamp. Errors include success: false and an error message.

Example — Success

// HTTP 200
{
  "success": true,
  "timestamp": "2026-03-10T12:00:00.000Z",
  "data": [ /* ... */ ]
}

Example — Error

// HTTP 400 / 404 / 500
{
  "success": false,
  "error": "Invalid asset type. Use: models, materials, hdris, textures, or other"
}

Asset Types

Wherever you see :assetType in an endpoint, use one of these five values (always lowercase):

models

materials

hdris

textures

other

Models

3D objects packaged as .fbx files inside a ZIP archive per resolution.

Materials

PBR texture sets — Color, Roughness, Normal, AO, Displacement in multiple resolutions.

HDRIs

High-dynamic-range environment maps in .exr format for lighting 3D scenes, packaged as ZIPs per resolution.

Textures

Standalone texture maps — imperfections, decals, overlays — usable across any material workflow.

Other

Additional assets that don't fit the main categories, such as brushes, presets, or apps.

Browse Assets

These endpoints return the full list of all assets for a given type as a single response. Ideal for building local caches or small integrations.

GET /previewsMaterials All materials +

Returns every material asset with name, category, sub-category, tags, preview image path, and download statistics.

Request

GET https://lazytextures.net:3000/previewsMaterials

Response (trimmed)

{
  "success": true,
  "summary": { "totalMaterials": 84 },
  "PreviewMaterials": [
    {
      "name": "Concrete01",
      "category": "Concrete",
      "subCategory": null,
      "type": "material",
      "basePath": "/Assets/Materials/Concrete/Concrete01",
      "preview": { "path": "/Assets/Materials/Concrete/Concrete01/Preview.png" },
      "tags": [ "concrete", "outdoor" ],
      "downloads": { "total": 342 }
    }
  ]
}

GET /previewsModels All models +

Returns all 3D model assets. Response key is PreviewModels, summary key is totalModels.

Request

GET https://lazytextures.net:3000/previewsModels

GET /previewsHDRIs All HDRIs +

Returns all HDRI environment maps. Summary key is totalHDRIs.

Request

GET https://lazytextures.net:3000/previewsHDRIs

GET /previewsTextures All textures +

Returns all standalone texture assets. Summary key is totalTextures.

Request

GET https://lazytextures.net:3000/previewsTextures

GET /previewsOther All other assets +

Returns all miscellaneous assets. Summary key is totalOther.

Request

GET https://lazytextures.net:3000/previewsOther

Paginated Browse

GET /previews-paginated/:assetType Browse with pagination & sorting +

Browse any asset type page-by-page with full control over sort order. Ideal for building UIs with infinite scroll or pagination controls.

Query Parameters

Parameter	Type	Required	Description
offset	integer	optional	Starting position. Default: `0`
limit	integer	optional	Items per page. Default: `20`, max: `100`
sort	string	optional	Sort order. Default: `name-asc`. See options below.

Sort Options

name-asc name-desc downloads-asc downloads-desc date-asc date-desc category-asc category-desc

Example — Page 2, sorted by downloads

GET https://lazytextures.net:3000/previews-paginated/materials?offset=20&limit=20&sort=downloads-desc

Response (trimmed)

{
  "success": true,
  "assetType": "materials",
  "sort": "downloads-desc",
  "pagination": {
    "total": 84,
    "offset": 20,
    "limit": 20,
    "returned": 20,
    "currentPage": 2,
    "totalPages": 5,
    "hasMore": true,
    "nextOffset": 40
  },
  "data": [ /* array of asset objects */ ]
}

Search

The search API uses a fuzzy relevance scoring algorithm. Scores are calculated from name match, category match, sub-category match, and tag match. Results with zero relevance are excluded automatically. At least one search parameter must be provided.

GET /all/Search Search across all asset types +

Search across all asset types in a single request. Returns which type each result belongs to via the assetType field.

Query Parameters

Parameter	Type	Required	Description
q	string	optional*	Free-text search query. Also accepts `query`.
tags	string	optional*	Comma-separated tag list. e.g. `wood,outdoor`
category	string	optional*	Exact category filter. e.g. `Concrete`
subCategory	string	optional*	Exact sub-category filter.
type	string	optional	Limit to one asset type: `models`, `materials`, `hdris`, `textures`, `other`
minDownloads	integer	optional	Minimum total download count filter.
sortBy	string	optional	`relevance` (default), `downloads`, `name`, `date`
limit	integer	optional	Max results. Default: `50`, max: `200`
offset	integer	optional	Pagination offset. Default: `0`

* At least one of q, tags, category, or subCategory is required.

Example — Search "wood" across all types

GET https://lazytextures.net:3000/all/Search?q=wood&sortBy=relevance&limit=10

Example — Filter by tags, limit to materials

GET https://lazytextures.net:3000/all/Search?tags=metal,rust&type=materials

Response (trimmed)

{
  "success": true,
  "query": {
    "search": "wood",
    "sortBy": "relevance"
  },
  "pagination": {
    "total": 12,
    "hasMore": false,
    "nextOffset": null
  },
  "results": [
    {
      "name": "Wood_Oak01",
      "category": "Wood",
      "assetType": "materials",
      "tags": [ "wood", "oak" ],
      "relevanceScore": 72.5
    }
  ],
  "breakdown": { "materials": 10, "models": 2 },
  "suggestions": {
    "categories": [ "Wood", "Forest" ],
    "tags": [ "wood", "oak", "natural" ]
  }
}

GET /:assetType/Search Search within one asset type +

Same search capabilities as /all/Search but scoped to a single asset type. Slightly faster for type-specific queries. Accepts the same query parameters (excluding type).

Example — Search concrete materials

GET https://lazytextures.net:3000/materials/Search?q=concrete&category=Concrete

Example — Search models by tag

GET https://lazytextures.net:3000/models/Search?tags=tree,nature&sortBy=downloads

Asset Details

GET /Asset/:assetType/:assetName Full details for one asset +

Returns complete information for a single asset including all available files (archives, texture maps, model files), their sizes, resolutions, and download paths. Files are grouped by resolution (e.g. 1K, 2K, 4K).

Path Parameters

Parameter	Type	Required	Description
assetType	string	required	One of: `models`, `materials`, `hdris`, `textures`, `other`
assetName	string	required	Exact asset name as returned by a list or search endpoint.

Example

GET https://lazytextures.net:3000/Asset/materials/Concrete01

Response (trimmed)

{
  "success": true,
  "name": "Concrete01",
  "assetType": "materials",
  "category": "Concrete",
  "tags": [ "concrete", "outdoor" ],
  "createdAt": "2025-08-14T00:00:00.000Z",
  "downloads": { "total": 342 },
  "archiveFiles": {
    "4k": [ {
      "name": "Concrete01_4k.zip",
      "path": "/Assets/Materials/Concrete/Concrete01/Mat/4k/Concrete01_4k.zip",
      "size": 22020096,
      "containsAllAssets": true
    } ],
    "8k": [ {
      "name": "Concrete01_8k.zip",
      "path": "/Assets/Materials/Concrete/Concrete01/Mat/8k/Concrete01_8k.zip",
      "size": 75497472,
      "containsAllAssets": true
    } ]
  }
}

Collections

Collections are curated groups of assets. Each asset type has its own set of collections. Replace Model below with Material, HDRI, Texture, or Other for the other types.

GET /ModelCollections List all model collections +

Returns all available model collections with name, description, and asset count.

Example

GET https://lazytextures.net:3000/ModelCollections

GET /ModelCollections/:name Assets in a collection +

Returns all assets belonging to a specific collection.

Example

GET https://lazytextures.net:3000/ModelCollections/Nature

All Collection Endpoints

/ModelCollections & /ModelCollections/:name
/MaterialCollections & /MaterialCollections/:name
/HDRICollections & /HDRICollections/:name
/TextureCollections & /TextureCollections/:name
/OtherCollections & /OtherCollections/:name

Download Files

GET /Asset/:assetType/:assetName/download/:fileName Download a specific file +

Streams a ZIP file directly to the client. Each ZIP contains all texture maps (Color, Roughness, Normal, Displacement, AO…) for that resolution. Use the path and name values from the archiveFiles object in the asset detail response to build this URL. Downloads are tracked automatically.

Path Parameters

Parameter	Type	Required	Description
assetType	string	required	Asset type, e.g. `materials`
assetName	string	required	Exact asset name
fileName	string	required	Exact file name as returned in `archiveFiles` or `textureFiles`

Example — Download the 4k ZIP (all maps included)

GET https://lazytextures.net:3000/Assets/Materials/Concrete/Concrete01/Mat/4k/Concrete01_4k.zip

Example — Download the 8k ZIP

GET https://lazytextures.net:3000/Assets/Materials/Concrete/Concrete01/Mat/8k/Concrete01_8k.zip

Library Statistics

GET /total-assets Total asset count by type +

Returns the total number of assets in the library broken down by type and category.

Request

GET https://lazytextures.net:3000/total-assets

Response (trimmed)

{
  "success": true,
  "totalAssets": 214,
  "byType": {
    "models": 32, "materials": 84,
    "hdris": 18, "textures": 64, "other": 16
  }
}

GET /most-downloaded Top downloaded assets +

Returns the most downloaded assets across the library, sorted by total download count.

Query Parameters

Parameter	Type	Required	Description
type	string	optional	Filter by type: `models`, `materials`, etc.
limit	integer	optional	Number of results. Default: `20`

Example

GET https://lazytextures.net:3000/most-downloaded?type=materials&limit=10

GET /newest-assets Most recently added assets +

Returns the most recently added assets across the library, sorted by creation date (newest first).

Query Parameters

Parameter	Type	Required	Description
type	string	optional	Filter by asset type.
limit	integer	optional	Number of results. Default: `20`

Example

GET https://lazytextures.net:3000/newest-assets?limit=5

GET /recently-downloaded Recently downloaded assets +

Returns assets sorted by most recent download activity — useful for discovering trending assets.

Query Parameters

Parameter	Type	Required	Description
type	string	optional	Filter by asset type.
limit	integer	optional	Number of results. Default: `20`

Example

GET https://lazytextures.net:3000/recently-downloaded

Response Format

Asset Object

Every asset object returned by list, search, and paginated endpoints shares this common structure:

name

Asset name, e.g. "Concrete_Worn01"

Frequently Asked Questions

Do I need an API key?

+

No. All public endpoints are completely open and require no authentication or API key.

What license do the assets use?

+

All assets are published under the CC0 1.0 Universal license. You can use them in personal or commercial projects with no attribution required.

Are there any rate limits?

+

There are no hard API rate limits for browsing and search endpoints. File downloads are subject to fair-use limits to protect server resources.

How do I get a preview image for an asset?

+

Each asset object contains a preview.path field. Prepend the base URL: https://lazytextures.net:3000 + preview.path to get the full image URL.

How does the search relevance score work?

+

Scores are computed using fuzzy string similarity across asset name (highest weight), category, sub-category, and tags. An exact name match scores higher than a partial match. Download popularity and recency provide a small additional boost.

Can I use the API in my own app or add-on?

+

Yes! The API is free to use. We'd love to hear about integrations — contact Lorenz@lazytextures.com.

Lazytextures Public API

Introduction

Base URL & Format

Response Envelope

Asset Types

Models

Materials

HDRIs

Textures

Other

Browse Assets

Paginated Browse

Search

Asset Details

Categories

Collections

All Collection Endpoints

Download Files

Library Statistics

Response Format

Asset Object

Frequently Asked Questions

Do I need an API key?

What license do the assets use?

Are there any rate limits?

How do I get a preview image for an asset?

How does the search relevance score work?

Can I use the API in my own app or add-on?