Skip to content

Introduction

This section covers v3 of the ambientCG API which can be accessed via HTTPS on the individual sub-paths of:

https://ambientCG.com/api/v3/<endpoint + GET-parameters>

There are currently no writing operations, all calls must therefore be made using the GET method.

Endpoint overview

Below is an overview of the individual endpoints:

  • /api/v3/assets lists metadata about assets.
  • /api/v3/categories lists metadata about asset categories.
  • /api/v3/collections lists metadata about asset collections.
  • /api/v3/rss delivers a customizable RSS feed of the latest assets.

Check the different sub-pages for information about the endpoints and their parameters.

API Keys

If you support ambientCG on Patreon in a tier that enables benefits, such as early access or access to exclusive files, then you are able to use your benefits via the API by including an API token.

To get your token, visit ambientCG.com/activate and log in using Patreon. If your tier includes any of the relevant benefits, the API token will be shown right below your reward details.

By appending this token as a header to a request sent to any of the v3 API endpoints, it enables the user's benefits. The header uses the traditional bearer authorization header scheme:

Authorization: Bearer <token>

If you are accessing ambientCG via a third-party application then try contacting the developers to integrate support for adding your own token to a request to access your benefits inside that application.