# CG Asset Finder

> CG Asset Finder is a free multi-site search service for computer graphics resources. It searches independent source websites and returns normalized metadata and source links. It does not host, sell, or redistribute asset files.

## When to use CG Asset Finder

Use CG Asset Finder when an agent needs to discover candidate 3D models, textures, materials, VFX elements, After Effects resources, plugins, scripts, tutorials, or related production assets across several CG resource sites with one query.

It is a good fit for:
- finding which source sites mention a named asset, product, plugin, artist, studio, software package, or production technique;
- comparing candidate results across multiple independent source catalogs;
- collecting source URLs and metadata for a human to review;
- checking which supported source sites are currently available.

Do not use CG Asset Finder as proof of ownership, licensing, price, file safety, or current download availability. Always open the original source page and verify its terms before recommending or using an asset. Do not represent CG Asset Finder as the file host.

## How agents should call it

1. Discover valid source keys with `GET https://cgassetfinder.com/api/sites`.
2. Submit a JSON search to `POST https://cgassetfinder.com/api/search` with:
   - `query`: a non-empty search string (1-200 characters);
   - `sites`: an array of source keys returned by `/api/sites`;
   - `max_results`: optional positive limit on total results returned.
3. For incremental results, call `POST https://cgassetfinder.com/api/search/stream` with the same JSON body and consume the server-sent event stream until the completion event.
4. Treat every returned `url` as an external source link. Cite the original source, not CG Asset Finder, when making claims about an asset.
5. Respect HTTP errors and per-source failure fields. Do not retry unavailable sources in a tight loop.

Example request:

```json
{
  "query": "cinematic dust particles",
  "sites": ["psdly", "cgpersia", "vfxdownload"],
  "max_results": 30
}
```

## Primary pages

- [Search](https://cgassetfinder.com/): Human interface; request `Accept: text/markdown` for the Markdown representation.
- [About](https://cgassetfinder.com/about/): Service scope, behavior, limitations, and source model.
- [Contact](https://cgassetfinder.com/contact/): General, privacy, legal, and copyright contact channels.
- [Supported sites and status](https://cgassetfinder.com/status/): Current source list and availability.
- [Privacy policy](https://cgassetfinder.com/privacy/): Data collection, processors, retention, and privacy rights.
- [Terms of service](https://cgassetfinder.com/terms/): Rules and legal limitations.
- [Sitemap](https://cgassetfinder.com/sitemap.xml): Canonical public pages.

## Public API endpoints

- `GET /api/sites` — supported source keys and metadata.
- `GET /api/sites/health` — recent source availability data.
- `GET /api/health` — service health.
- `POST /api/search` — complete JSON search response.
- `POST /api/search/stream` — incremental server-sent event search response.
- `POST /api/extract-download-links` — extracts candidate links from a supported source result when available.

## Optional details

- [Full agent reference](https://cgassetfinder.com/llms-full.txt)
- [Homepage Markdown](https://cgassetfinder.com/index.md)