How it works

1

Add your key

Create a free widget key in the dashboard and enter your shop's domain. Paste two lines of code on your product page — or install the WooCommerce plugin.

2

Customer uploads a photo

Right on your product page the customer picks a photo, width and drill type — no redirect, no account needed.

3

Preview + size advice

Within seconds they see a realistic diamond painting preview and the recommended size. Photo, size and preview flow straight into the order.

Live demo

Try it yourself — this is the exact widget your customers get

Powered by the same API and embed key your shop would use.

The problem we solve

One of the biggest reasons for returns and dissatisfaction with custom diamond paintings is that customers cannot properly estimate how their photo will look as a diamond painting. They choose a size that's too small, expect more detail than is possible, or only discover after receiving it that certain colours turn out differently.

By integrating our preview technology into your ordering process, you give customers a realistic expectation upfront. They see exactly how their photo looks at different sizes and drill types. The result: fewer returns, higher customer satisfaction and more trust in the ordering process.

What the API offers

Preview generation

Realistic diamond painting simulation based on the uploaded photo, chosen size and drill type.

Automatic size advice

Analyses photo details and recommends the optimal size with quality score per dimension.

Batch processing

Process multiple photos at once for catalogue updates or bulk orders.

Webhooks

Receive automatic notifications when previews are ready. Seamless integration with your order flow.

Fully customisable order form

The WooCommerce plugin lets you add your own fields — text, options, dropdowns and priced add-ons — so the form matches your shop. Need a bespoke setup? We build it with you.

Technical details

The API works via simple REST calls with Bearer token authentication. You send a photo and configuration, and receive a preview image plus detailed size advice back. The API supports both synchronous and asynchronous processing, depending on your use case.

If you run a Shopify store, start with the dedicated Shopify diamond painting preview setup. That page explains variant mapping and cart metadata in more detail, while this page remains the API owner.

REST API with JSON responses
Bearer token authentication with API key management via the dashboard
Rate limiting: 60 units/minute, 1,000 units/day per key (preview requests use weighted units)
Idempotency support for safe retry logic
Webhook notifications with HMAC-SHA256 signature verification
Full API documentation available

Pricing

Free

50 previews per day
30 requests per minute
Widget + API + WooCommerce plugin

Starter

€19/month

500 previews per day
60 requests per minute
Widget + API + WooCommerce plugin

Pro

€49/month

2500 previews per day
120 requests per minute
Widget + API + WooCommerce plugin

Start free — upgrade any time from your dashboard.

Getting started

You can start right away via the B2B dashboard. Create an account, generate your API key and follow the quickstart guide. Within an hour you'll have the first integration running.

Have questions or want to discuss the possibilities for your specific situation? Contact us for a personal conversation.

Diamond Painting Preview API for Webshops