Poly Haven Scraper

Extract 3D assets from Poly Haven — a free, public-domain (CC0) library of HDRIs, PBR textures, and 3D models widely used by 3D artists, game developers, and VFX/archviz studios. Browse by asset type and category, search by keyword, or look up specific assets by ID. Every record includes full metadata plus direct, no-login download links for every available resolution and file format.

Features

• 4 scraping modes — browse, keyword search, ID lookup, category discovery
• 3 asset catalogs — HDRIs (environment lighting), textures (PBR materials), models (3D objects)
• Direct CC0 download links — every resolution (1k–24k) and format (EXR/HDR/JPG/PNG/blend/FBX/glTF/USD) with file sizes
• Rich metadata — tags, categories, authors, resolution, polycount, real-world dimensions, and more
• 19–48 categories per asset type — selectable dropdowns, e.g. "outdoor", "furniture", "night", "wood"
• No authentication required — uses the free public Poly Haven API (no key, no login, no proxy)

Input

Field	Type	Description	Default
mode	Select	Scraping mode	browse
assetType	Select	hdris, textures, models, or all	hdris
hdriCategory	Select	Category filter (mode=browse/search, assetType=hdris/all)	—
textureCategory	Select	Category filter (mode=browse/search, assetType=textures/all)	—
modelCategory	Select	Category filter (mode=browse/search, assetType=models/all)	—
searchQuery	String	Keyword to match against name/tags/categories/description (mode=search)	wood
assetIds	Array	Poly Haven asset IDs to look up directly (mode=byId)	[]
includeDownloadLinks	Boolean	Fetch direct download URLs for every resolution/format	true
maxItems	Integer	Maximum number of records to return	30

Modes

Mode	Description
browse	List assets of the chosen type, optionally filtered by category
search	Keyword search across name, tags, categories, and description
byId	Look up specific assets directly by their Poly Haven ID (the slug from a polyhaven.com/a/{id} URL)
listCategories	List every category for the chosen asset type along with its asset count — useful for discovering valid category filter values

Example Input

{
  "mode": "search",
  "assetType": "textures",
  "searchQuery": "wood",
  "maxItems": 20,
  "includeDownloadLinks": true
}

Output

Field	Type	Description
assetId	String	Poly Haven's unique asset slug
name	String	Asset name
assetType	String	hdri, texture, or model
category	String	Full category path (e.g. Wood/Bark/Furrowed Bark)
categories	Array	Top-level category tags
tags	Array	Search tags
description	String	Asset description
authors	Array	Author name(s)
thumbnailUrl	String	Preview image URL
downloadCount	Integer	Total downloads on Poly Haven
datePublished	String	ISO 8601 publish date
maxResolution	Array	[width, height] in pixels (HDRIs/textures)
coordinates	Array	[lat, lon] where the HDRI was captured (HDRIs only)
whitebalanceKelvin	Integer	White balance in Kelvin (HDRIs only)
evsCap	Integer	Exposure value cap (HDRIs only)
hasBackplates	Boolean	Whether matching backplate photos are available (HDRIs only)
realWorldDimensionsCm	Array	Real-world texture tile size in cm (textures only)
polycount	Integer	Polygon count (models only)
texelDensity	Number	Texel density (models only)
dimensionsMm	Array	[x, y, z] bounding box in mm (models only)
attributes	Object	Extra type-specific attributes (surface use, material, condition, etc.)
sourceUrl	String	Link to the asset's Poly Haven page
downloadFiles	Object	Direct CC0 download URLs, organized by map/resolution/format, each with url and sizeBytes
availableFormats	Array	Unique file formats available for this asset
scrapedAt	String	ISO timestamp

Example Output

{
  "assetId": "aarfontein_dirt_road",
  "name": "Aarfontein Dirt Road",
  "assetType": "hdri",
  "category": "Desert & Arid/Karoo & Scrubland/Dirt Roads & Tracks",
  "categories": ["outdoor", "nature", "natural light", "high contrast", "clear", "morning-afternoon"],
  "tags": ["sun", "arid", "gravel", "dirt road", "scrubland", "tracks"],
  "authors": ["Dario Barresi", "Jarod Guest"],
  "thumbnailUrl": "https://cdn.polyhaven.com/asset_img/thumbs/aarfontein_dirt_road.png?width=256&height=256",
  "downloadCount": 975,
  "maxResolution": [24576, 12288],
  "sourceUrl": "https://polyhaven.com/a/aarfontein_dirt_road",
  "downloadFiles": {
    "hdri": {
      "1k": {"exr": {"url": "https://dl.polyhaven.org/.../aarfontein_dirt_road_1k.exr", "sizeBytes": 5779773}}
    }
  },
  "availableFormats": ["exr", "hdr", "tonemapped"],
  "scrapedAt": "2026-07-03T12:00:00+00:00"
}

FAQ

Do I need an API key or Poly Haven account? No. Poly Haven's API (api.polyhaven.com) is fully public and keyless — this actor requires no login, cookies, or proxy.

Are the assets really free to use? Yes. Every asset on Poly Haven is released under the CC0 public-domain license — free for personal and commercial use, no attribution required (though appreciated).

How many assets are available? Roughly 2,300+ assets: ~980 HDRIs, ~780 textures, and ~520 models, growing regularly.

What resolutions/formats can I download? Depends on the asset — HDRIs go up to 24K in EXR/HDR; textures up to 8K in JPG/PNG/EXR; models include multiple texture map resolutions plus blend/FBX/glTF/USD mesh files. Every record's downloadFiles field lists exactly what's available for that specific asset.

Can I search across all three catalogs at once? Yes — set assetType to all in browse or search mode.

Can I disable the download-link enrichment for faster runs? Yes — set includeDownloadLinks to false to return metadata-only records with one API call per asset type instead of one extra call per asset.

What categories are available? HDRIs: natural light, outdoor, nature, urban, skies, night, studio, and more (19 total). Textures: wood, brick, fabric, metal, concrete, and more (48 total). Models: furniture, props, plants, electronics, vehicles-adjacent categories like weapons/ships, and more (36 total). Use mode=listCategories to fetch the full live list with asset counts for any type.