← All agent tools

Media assets Poly Haven

Poly Haven API

Discover downloadable lighting environments, textures and 3D models from Poly Haven’s CC0 collection.

Source review: 2026-10-17 · Imported: 1 November 2026

A practical starting point

What could you build?

A scene building assistant can find an HDRI and suitable surface textures for a Blender project.

Before you connect

Send an application identifier with API calls and follow the API attribution rules. Asset rights and live API terms are separate.

Capabilities & requirements

Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.

Poly Haven API specifications
CapabilityDetails and source
StatusNot published

The README says the API is currently live; the terms say it is provided as available with no uptime guarantee. No stage label.

Source (external) · Not published by vendor: checked 2026-10-17 on https://github.com/Poly-Haven/Public-API
API key requiredNo key; send a User-Agent

Calls must carry a unique Referer or User-Agent naming your software.

Source (external) · Verified 2026-10-17 on https://github.com/Poly-Haven/Public-API/blob/master/ToS.md
Free tierFree for any use

Poly Haven will never require payment, a license or a key.

Source (external) · Verified 2026-10-17 on https://github.com/Poly-Haven/Public-API/blob/master/ToS.md
Rate limitNot published

No numeric limit is published; the acceptable-use clause applies.

Source (external) · Not published by vendor: checked 2026-10-17 on https://github.com/Poly-Haven/Public-API/blob/master/ToS.md
Official MCP serverNot published

No official MCP server is listed.

Source (external) · Not published by vendor: checked 2026-10-17 on https://github.com/Poly-Haven/Public-API
Official SDKNot published

No official SDK is listed; the README links the OpenAPI docs and terms.

Source (external) · Not published by vendor: checked 2026-10-17 on https://github.com/Poly-Haven/Public-API
Data license / termsCC0 assets; credit for live API use

Apps that surface live API results must credit Poly Haven.

Source (external) · Verified 2026-10-17 on https://github.com/Poly-Haven/Public-API/blob/master/ToS.md
Commercial use allowedYes, including for-profit

Terms section 2.1–2.3.

Source (external) · Verified 2026-10-17 on https://github.com/Poly-Haven/Public-API/blob/master/ToS.md
CORS / browser useAccess-Control-Allow-Origin: *

Returned on a GET with a third-party Origin header.

Source (external) · Verified 2026-10-17 by test request to https://api.polyhaven.com/search?q=brick&t=textures
Freshness / coverage997 HDRIs, 869 textures, 521 models

Counts from /assets?type=hdris|textures|models.

Source (external) · Verified 2026-10-17 by test request to https://api.polyhaven.com/assets?type=hdris

Operational reference

Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.

Price

Free for anyone, for any purpose, including commercial use. The terms say Poly Haven will never require payment, a license or a key to use the API.

Provider reference (external)

API key / auth

Not required. The API terms do require a unique User-Agent or Referer header that names your software.

Provider reference (external)

Rate limit

No numeric limit is published. The acceptable-use clause bans anything that degrades the API for others, and responses are cached (cache-control: max-age=43200 on the source publisher’s test).

Provider reference (external)

Terms

Live API use inside your app, site or service must visibly credit Poly Haven (for example "Powered by Poly Haven"). Downloaded CC0 assets need no attribution.

Provider reference (external)

Licensing

Every asset is CC0: use it for anything, commercial included, with no attribution required.

Provider reference (external)

Catalog size

997 HDRIs, 869 textures and 521 models (counts from /assets?type=… on the check date).

Provider reference (external)

Status

Provided "as available" with no uptime guarantee; Poly Haven may change or suspend the API without notice.

Provider reference (external)

Endpoints

/assets, /search?q=…&t=…, /info/{id}, /files/{id}, /taxonomy, /types (OpenAPI spec published).

Provider reference (external)

Setup references

HTTP request example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

curl -sS -A "my-agent/1.0" "https://api.polyhaven.com/search?q=brick&t=textures"
Agent connection example

Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.

// Agent tool definitions (JSON Schema) — implement with HTTP GET
// Always send User-Agent: <your-app-name>/<version>
[
  {
    "name": "polyhaven_search",
    "description": "Search CC0 assets on Poly Haven. Returns slugs, best match first.",
    "input_schema": { "type": "object",
      "properties": { "q": { "type": "string" },
                      "t": { "type": "string", "enum": ["hdris", "textures", "models"] } },
      "required": ["q"] }
  },
  {
    "name": "polyhaven_files",
    "description": "Download URLs for one asset by map, resolution and format.",
    "input_schema": { "type": "object",
      "properties": { "slug": { "type": "string" } }, "required": ["slug"] }
  }
]
// GET https://api.polyhaven.com/search?q={q}&t={t}
// GET https://api.polyhaven.com/files/{slug}

A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.

Other connections to explore

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.