The CC0 Textures API (v1)

The CC0 Textures API allows you to pull metadata and download links for all assets on CC0 Textures. This page offers an overview over all functions provided by the API.

The API can be called by sending GET-Requests to

https://cc0textures.com/api/v1/<function + GET-parameters>

All functions are listed below.

Available functions

The API currently has 3 ways of outputting data:

/full_json

Returns a list of assets with their metadata, links to preview images and downloads in json notation.
Try it with default settings.

/downloads_csv

Returns a list of assets with just their downloads in csv notation.
Try it with default settings.

/rss

Returns an RSS feed of assets with an image and download links.
Try it with default settings.

Downloads: Pretty vs. Raw

When looking at the data returned by the API you will see two kinds of download links: “Pretty” and “Raw”.

Pretty links are short and easy to understand. When accessing a pretty link you will be redirected to the raw link which actually offers the file and your download will be logged for the statistics. In the interest of accurate data I would ask you to use the pretty links whenever possible as they are responsible for counting the downloads. But if the HTTP-Redirects of the pretty links pose a problem for your implementation you are free to use the raw variant instead.

Filters (for all functions)

By default all functions return a full list featuring all assets that CC0 Textures has to offer. The output of all functions (even the RSS feed) can be limited/filtered using the GET-parameters listed below.

All functions support the same syntax as the list page of CC0 Textures (cc0textures.com/list) meaning that all GET-parameters can be copied from the /list page.
For Example: Searching for the most popular photoscanned PBR materials using the CC0 Textures website sends you to this URL:

https://cc0textures.com/list?q=&method=HeightFieldPhotogrammetry&type=PhotoTexturePBR&sort=Popular

This list of assets can be accessed via the API using this URL:

https://cc0textures.com/api/v1/full_json?q=&method=HeightFieldPhotogrammetry&type=PhotoTexturePBR&sort=Popular

Here is a full overview over all parameters:

Parameter Explanation
qSearch Query. Can contain any number of tags, separated by a comma. Spaces will be converted to commas.
methodDefines the method that was used to create the texture. Can be set to
  • BitmapApproximation

    The material has been approximated from just a color map.

  • HeightFieldPhotogrammetry

    The material's displacement map was created using photogrammetry.

  • SubstanceDesignerProcedural

    The material was created fully procedurally in Substance Designer.

  • SubstanceDesignerPhotoBased

    The material was created using Substance Designer and premade assets (such as photoscanned elements).

  • MultiAngleApproximation

    The material was created using multi-angle approximation.

  • PlainPhoto

    The material is just a plain photo, no further material processing was done.

  • 3DPhotogrammetry

    This asset is a 3D model that was created using photogrammetry.

  • Jsplacement

    Materials that were created using the software Jsplacement.

Multiple values can be concatenated using a comma. Not setting the parameter or sending an empty string will disable the filter. Any other value will lead to 0 results.

type Defines the data type of the assets, for example PBR materials, Substance files or 3D models. Can be set to
  • PhotoTexturePBR for PBR materials.
  • AtlasPBR for PBR atlases (for example leaf sets).
  • PhotoTexturePlain for Photo textures (such as backdrops).
  • SBSAR for Substance archives
  • 3DModel for 3D models.
  • Terrain for terrains.

Multiple values can be concatenated using a comma. Not setting the parameter or sending an empty string will disable the filter. Any other value will lead to 0 results.

sortDefines the order of results. Can be set to
  • Latest to sort by releasedate (descending).
  • Popular to sort by popularity score (descending).
  • Alphabet to sort alphabetically (ascending).

Any other values (including an empty string) will default to “Latest”. This parameter is not available for the rss feed which always shows the latest assets.

idIf set to a non-empty string it only matches the one specific AssetID (for example “PavingStones036” or “RockSubstance003”). Useful if you want to pull the data for one specific asset.
dateReturns all assets for one specific release date formatted “YYYY-MM-DD”.
limitDefines the maximum number of results to be shown. Setting it to -1 or not setting it at all disables the limit and shows all results.
offsetDefines the offset in the results. Setting it to 0 or not setting it at all returns the results starting with the first one. 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.



CC0 Textures
CC0 Textures Material Creation Guide
CC0 Textures on Patreon
CC0 Textures on Twitter
CC0 Textures on Instagram


User Tools