/api/v3/assets

This endpoint delivers metadata and downloadable files for all assets in a JSON-format. The output can be filtered using HTTP GET parameters.

Try it out with default settings.

Tip

The parameters used for this endpoint are practically identical to the search parameters used on the website. You can make your selection on ambientCG.com/list and simply copy the parameters, like this:

         https://ambientCG.com/list | ?type=material&q=sand&sort=latest
https://ambientCG.com/api/v3/assets | ?type=material&q=sand&sort=latest&include=downloads

Parameters

This is the full list of parameters that can be used to filter and sort the results.

Parameter	Description	Allowed values	Notes
q	Search Query.	A list of keywords, separated by commas or spaces.	Multiple keywords are combined using a logical AND.
type	The data type of the assets.	material hdri substance decal atlas 3d-model plain-image brush terrain hdri-element	Multiple values can be concatenated using a comma which will be interpreted as a logical OR. Not setting the parameter or setting it to an empty string will disable the filter. Any invalid value will lead to zero results.
technique	Technique used to create the asset.	hdri-bracketed-panorama hdri-bracketed-panorama-horizon-clearing hdri-panorama-procedural hdri-bracketed-element surface-photogrammetry surface-fully-procedural surface-approximated surface-photometric-stereo surface-procedural-bitmap-elements model-photogrammetry terrain-gaea plain-photo	Multiple values can be concatenated using commas which will be interpreted as a logical OR. Not setting the parameter or setting it to an empty string will disable the filter. Any invalid value will lead to zero results.
sort	Defines the order of the results.	popular latest downloads oldest random alphabet	Not setting the parameter, setting it to an empty string or any other value will be interpreted as popular
id	Can be used to select specific assets by their id.	PavingStones036 Plastic015A 3DApple001 RockSubstance003 ...	Multiple values can be concatenated using a comma. Non-existent ids will be ignored.
date	Returns all assets released on one specific day.	Date string formatted as YYYY-MM-DD	Invalid values will lead to zero results.
limit	Defines the maximum number of results to be shown.	Integer between 1 and 500.	If the parameter is not present or outside the valid range, it will be clamped or replaced with a default of 100.
offset	Defines the offset in the results.	Integer >= 0	Setting it to a positive number causes this number of assets to be skipped. The offset will only take effect if a limit (see above) has been set.
include	Controls what data should be returned.	type releaseDate shortDescription longDescription title url tags colors dimensions downloadStatistics maps technique downloads relations collections previews thumbnails	Multiple values can be concatenated using a comma.