Stuller
  • Cart
  • Login
Stuller
Search...

API Documentation and Examples

Stuller’s API (Application Programming Interface) allows your website to connect directly to our inventory, ensuring real-time product availability, pricing, and details. This integration helps streamline operations and enhance your customers’ shopping experience. Be sure to partner with a web developer who has the technical expertise to maximize the benefits of the API.

General Information on Stuller’s APIs

The Stuller API is a collection of REST endpoints that enable a client to interact with Stuller. Given the complexity of some of the requests, each HTTP GET endpoint will also support HTTP POST method. Request and Response structure can be found at https://api.stuller.com/help.

Familiarize yourself with our suite of APIs by reviewing the information below.

NOTE: While our Product and Gem APIs provide real-time product information, we strongly suggest downloading and staging the necessary data to maintain your website's product listings. Our APIs are not built to support the real-time loading of other websites.

Product API

Retrieve all data for any Stuller product(s) including real-time pricing and availability information.

Product Configuration API

The configuration section of the Stuller Product API is a set of REST endpoints used to receive data on Stuller configurations.

Virtual Product API

The Stuller Virtual Product API is a REST endpoint used to receive data on Stuller’s virtual products. Virtual products are semi-set jewelry products created exclusively for the API with the intent to alleviate challenges with pricing and media.

Gem API

Retrieve data for all active diamonds with reports and Notable Gems® (a unique, hand-selected collection of gemstones). Stuller carries unique diamonds and gemstones, which are broken out into three different categories: large natural diamonds with reports, large lab-grown diamonds with reports, and Notable Gems.

Order API

The Order API allows you to transmit orders to Stuller and check the status of previous orders. This is ideal to use in conjunction with Stuller's Pack and Ship dropshipping services.

Invoice API

The Invoice API is used to retrieve available invoice and tracking information for previously placed orders.

Frequently Asked Questions

API stands for Application Programming Interface. It is the programmatic way to retrieve the necessary product data you need to list our items on your website.

If your developer is utilizing our APIs (separate from our data feeds) to pull product data, you can create a developer login from the Create/Manage Logins section of My Account.

A developer login is a set of Stuller.com credentials that cannot be used to log in to Stuller.com. It can only be used as authorization when making requests to our APIs.

Other options include, but are not limited to, the following:



Instead of spending time, money, and other resources on building an e-commerce website, your efforts may be better spent on a simple content website. These are much easier to build and maintain, and still help you build your online presence locally.



Utilize Stuller Showcase®. While not a true e-commerce solution, our showcase feature can be used to introduce your online presence. This feature allows your customers to browse Stuller's products within your customized, templated design with retail pricing you set. If you have an existing website, this feature can be embedded onto your website to offer the same shopping experience, while still appearing that your customers are browsing your website.



Hire an outside company to build your website. It can be difficult to find a reliable company to build a website, especially one that represents your brand. Stuller recommends Punchmark for this type of work.