Media assets ambientCG
ambientCG API
Search ambientCG’s material library and obtain download options for the resolutions and formats your project needs.
Source review: 2026-10-27 · Imported: 1 November 2026
A practical starting point
What could you build?
A design assistant can assemble a shortlist of wood or concrete materials for a scene.
Before you connect
Cache metadata and download only the required resolution. Public assets and supporter extras have different access paths.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | Not published v3 is the current API and v2 no longer receives updates; no beta or GA label and no SLA. The docs warn it is run by one person and not built for enterprise reliability. Source (external) · Not published by vendor: checked 2026-10-27 on https://docs.ambientcg.com/api/v3/ |
| API key required | No key for public assets An optional Bearer token only unlocks Patreon early-access or exclusive files. Source (external) · Verified 2026-10-27 on https://docs.ambientcg.com/api/v3/ |
| Free tier | Free; no paid API tier All assets are free to download; Patreon support adds early access. Source (external) · Verified 2026-10-27 on https://docs.ambientcg.com/api/v3/ |
| Rate limit | Not published No numeric limit is published, and the source publisher’s test responses carried no rate-limit headers. Source (external) · Not published by vendor: checked 2026-10-27 on https://docs.ambientcg.com/api/ |
| Official MCP server | Not published No official MCP server is listed in the docs. Source (external) · Not published by vendor: checked 2026-10-27 on https://docs.ambientcg.com/api/ |
| Official SDK | Not published No official SDK is listed; the docs describe plain HTTPS GET endpoints. Source (external) · Not published by vendor: checked 2026-10-27 on https://docs.ambientcg.com/api/v3/ |
| Data license / terms | CC0 1.0 assets Applies to the asset files and preview renders; credit optional. No separate API terms are published. Source (external) · Verified 2026-10-27 on https://docs.ambientcg.com/license/ |
| Commercial use allowed | Yes, CC0 Copy, modify and use commercially without asking permission. Source (external) · Verified 2026-10-27 on https://docs.ambientcg.com/license/ |
| CORS / browser use | No CORS header GET and preflight with a third-party Origin returned no Access-Control-Allow-Origin. Source (external) · Verified 2026-10-27 by test request to https://ambientcg.com/api/v3/assets?type=material&q=wood |
| Freshness / coverage | 2,037 materials, 434 HDRIs, 34 models totalResults from /api/v3/assets?type=material|hdri|3d-model. Source (external) · Verified 2026-10-27 by test request to https://ambientcg.com/api/v3/assets?type=material&limit=1 |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
Price
Free. Every asset is downloadable at no cost; Patreon supporters get extras such as early access, which the v3 API unlocks with their token.
Provider reference (external)API key / auth
Not required for public assets. An optional Authorization: Bearer token (from ambientCG.com/activate, for Patreon supporters) only enables early-access or exclusive files.
Provider reference (external)Rate limit
No numeric limit is published, and the source publisher’s test responses carried no rate-limit headers. The API docs warn that it is run by one person and may not be reliable enough for enterprise use, so cache results.
Provider reference (external)License / terms
All assets, including the preview renders, are CC0 1.0: copy, modify and use them commercially without permission. Credit is optional but appreciated. No separate API terms of service are published.
Provider reference (external)Version status
v3 is the current API. The v2 docs say v2 no longer receives updates and new projects should use v3 (v2 still answered the source publisher’s test).
Provider reference (external)Catalog size
2,037 materials, 434 HDRIs and 34 3D models (totalResults from /api/v3/assets?type=… on the check date).
Provider reference (external)Endpoints
GET /api/v3/assets (search and filter), /api/v3/categories, /api/v3/collections and /api/v3/rss. limit accepts 1 to 500 (default 100). There are no write operations.
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://ambientcg.com/api/v3/assets?type=material&q=wood&limit=2&include=title,downloads"Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
// Agent tool definition (JSON Schema) — implement with HTTP GET, no key
[
{
"name": "ambientcg_search",
"description": "Search CC0 materials, HDRIs and models on ambientCG. Returns ids, titles and zip download links per resolution.",
"input_schema": { "type": "object",
"properties": {
"q": { "type": "string", "description": "Keywords, ANDed" },
"type": { "type": "string", "enum": ["material", "hdri", "decal", "3d-model", "terrain"] },
"limit": { "type": "integer", "minimum": 1, "maximum": 500 }
},
"required": ["q"] }
}
]
// GET https://ambientcg.com/api/v3/assets?q={q}&type={type}&limit={limit}&include=title,tags,downloadsA 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.