Shopify Ajax API

The Ajax API provides a suite of lightweight REST API endpoints for development of Shopify themes.

Use cases

Possible uses of the Ajax API include:

• Add products to the cart and update the cart item counter.

• Display related product recommendations.

• Suggest products and collections to visitors as they type in a search field.

Making requests to the API

The Ajax API accepts two types of HTTP requests:

• GET requests to read cart and some product data

• POST requests to update the cart for the current session

For instance, to fetch the current contents of the cart, send a client-side request to the store’s /cart.js endpoint.

var cartContents = fetch(window.Shopify.routes.root + 'cart.js')
  .then(response => response.json())
  .then(data => { return data });

Note

The Ajax API can only be used by themes that are hosted by Shopify. You can't use the Ajax API on a Shopify custom storefront.

Important :

Shopify’s Ajax API can be used in Shopify themes to carry out actions like adding items to the cart, and displaying suggested products without requiring any page refreshes from buyers.

The Ajax API includes the following endpoints:

• Cart - Update cart line items, attributes, and notes.

• Product - Fetch information about any product in the catalog.

• Product Recommendations - Display recommended products on product pages.

• Predictive Search - Suggest products, collections, pages and articles to buyers as they type their search queries.

Requirements and limitations

• This is an unauthenticated API. It doesn’t require access tokens or a client ID to access.

• There are no hard rate limits on the Ajax API. It’s still subject to Shopify’s standard API abuse-prevention measures.

• All API responses return JSON-formatted data.