← All agent tools

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.

ambientCG API specifications
CapabilityDetails and source
StatusNot 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 requiredNo 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 tierFree; 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 limitNot 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 serverNot 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 SDKNot 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 / termsCC0 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 allowedYes, CC0

Copy, modify and use commercially without asking permission.

Source (external) · Verified 2026-10-27 on https://docs.ambientcg.com/license/
CORS / browser useNo 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 / coverage2,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,downloads

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.