Discovery API documentation
The Discovery API is the API which is designed to power your storefront with product information and marketing content. It is a read only API that is distributed and designed for read performance. You can browse, search, filter, facet and sort your data from Crystallize via the Discovery API.
It is designed to replace the catalogue API and search API (to be deprecated) as one API for fetching data from your Crystallize tenant. Discovery is a semantic API which means that the API signature follows the structure of your shapes and the components on your shape.
In this section
Base URL
You can access the Discovery API from the following URL. Remember to replace the tenant-name with your tenant identifier.
https://api.crystallize.com/tenant-name/discoveryAll queries in this Discovery documentation is connected to the demo site Furnitut which is using a best practice setup for content modeling. You can check out our open-source Next.js commerce storefront accelerator which is built on top of this tenant.
API Access
By default, this is an open endpoint. However if you set up restricted access for your Catalogue API, you would need to provide the static token or access tokens as required.
Example Query
Before we dive deeper into the queries, let’s take a look at a basic example: