A list of assets, including their individual metadata.
To filter the returned data, some optional arguments can by provided in the request URL (e.g. /assets?t=hdris&c=outdoor)
Query parameters
Filter to assets of a particular type. Can be hdris/textures/models/all.
(Legacy) A comma-separated list of categories to filter by. Only assets that match all categories specified will be included. Use the /categories endpoint to get a list of available categories.
Filter by the single-path category taxonomy. Accepts either the canonical path (Brick & Block/Clay Brick) or the URL slug path (brick-block/clay-brick). Matching is inclusive: a parent category also returns everything nested beneath it. Use the /taxonomy endpoint to get the full tree.
Filter to assets belonging to a collection (see /collections).
Filter to assets belonging to a vault (see /vaults).
Any attribute key valid for the requested type may be used as its own query parameter, e.g. ?weather=clear, ?environment=outdoor, ?material=wood,metal. Multiple comma-separated values are OR'd together, and different attributes are AND'd. An unrecognised value returns 400 rather than silently matching everything. Boolean attributes are stored only when true, so an absent value counts as false. Every attribute whose false side is meaningful in its own right is an enum instead, where an absent value means "not assessed" and matches nothing. See /taxonomy/{type} for the attribute schema of each type.
Response
OK
Example response
{
"aerial_asphalt_01": {
"name": "Aerial Asphalt 01",
"description": "Free 8K aerial-view texture of cracked, weathered asphalt, tileable for outdoor road/pavement surfaces.",
"type": 1,
"date_published": 1597061145,
"download_count": 33151,
"files_hash": "f55493e46c51f95b51bb5952d0b38d634937f3b2",
"authors": {
"Rob Tuytel": "All"
},
"categories": [
"asphalt",
"outdoor",
"floor",
"road",
"man made"
],
"category": "Asphalt & Bitumen/Asphalt/Cracked Asphalt",
"category_id": "ae6df066-2cbf-5772-9092-3cd86ed6394e",
"tags": [
"road",
"flat",
"cracked"
],
"attributes": {
"surface_use": "floor",
"origin": "man_made",
"setting": "outdoor",
"condition": [
"weathered"
]
},
"max_resolution": [
8192,
8192
],
"dimensions": [
30000,
30000
],
"thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/aerial_asphalt_01.png?width=256&height=256"
},
"aerial_beach_01": {
"name": "Aerial Beach 01",
"description": "Free 16K aerial-view texture of wavy coastal beach sand, tileable for natural outdoor terrain.",
"type": 1,
"date_published": 1601489165,
"download_count": 33556,
"files_hash": "8746a9a941bebe5743d0a710e11cb91beb225ca6",
"authors": {
"Rob Tuytel": "All"
},
"categories": [
"terrain",
"sand",
"outdoor",
"natural"
],
"category": "Ground & Terrain/Sand/Beach & Coastal Sand",
"category_id": "2bed9a9d-8f5f-5f1f-815c-e33cfa63bf69",
"tags": [
"beach",
"wavy",
"costal",
"ocean",
"seaside"
],
"attributes": {
"surface_use": "ground",
"origin": "natural",
"setting": "outdoor",
"aerial": true
},
"max_resolution": [
16384,
16384
],
"dimensions": [
30000,
30000
],
"thumbnail_url": "https://cdn.polyhaven.com/asset_img/thumbs/aerial_beach_01.png?width=256&height=256"
}
}