As I mentioned previously we follow the JSON API spec. This means we can scale our API and provide a consistent API as we introduce new endpoints.

There are a lot of libraries that make working with JSON API easier. See this list of JavaScript libraries that make working with includes easier.

One of the benefits of JSON API is smaller payloads. If you make a request to get products and include categories, you’ll embed the category data for each product, which isn’t ideal when working with headless APIs, as you want the fastest response possible.