Put a prize wheel on your website

Developer docs

One copy-paste snippet embeds the same animated wheel and gacha machine trusted by streamers — on your shop, community site, or event page. Visitors spin right on your page. Your server can trigger spins. Every result reaches your system.

<script src="https://wheelofitem.com/embed.js" data-key="pk_live_YOUR_KEY" data-widget="wheel"></script>

That's the whole integration for visitor spins. Design the wheel itself in your dashboard — colors, prizes, weights.

🖱️ Visitors spin on your page

A Spin button under the live widget. Per-visitor daily limits you control, and rolls decided on our servers so nobody can cheat the odds.

Trigger from your system

POST /api/v1/trigger with your secret key — after a signup, a finished quest, a milestone. The wheel spins live for everyone watching.

Results by signed webhook

Every spin result is POSTed to your endpoint with an HMAC signature, so your backend can hand out the coupon, prize, or points.

Your design, our engine

Build the wheel or gacha in the dashboard exactly like streamers do — same physics, same animations, same cute themes.

Included with Pro

from $3 / month
  • 2,000 spins / month on your website
  • All five widgets — wheel, gacha, tarot, claw, photo booth — one shared quota
  • 1 website (up to 3 domains — staging covered)
  • Plus everything in streamer Pro on wheelofitem.com

Embed Plus — for busy sites

$6.50 / month
  • 50,000 spins / month
  • Everything in Pro included
  • Same widgets, trigger API and webhooks
  • Monthly by card — cancel any time
Start free 14-day trial

Trial: 14 days, Pro included, 2,000 spins, no card. A spin = one visitor spin or one API trigger. You set a daily limit per visitor; at the monthly limit the widget pauses until next month.

FAQ

Which widgets can I embed?

All five — wheel, gacha, tarot, claw machine and photo booth. Configure each separately in the dashboard (or use them all); usage shares one monthly quota.

How do results reach my system?

Instantly on the page (animation + a JavaScript woi:result postMessage), and server-side by signed webhook within about a minute of each spin.

Can my own system trigger a spin?

Yes — POST /api/v1/trigger with your secret key. Perfect for "signup → spin" or "milestone → spin" moments on your own site. Don't use it to sell chances at prizes of value (see our Terms).

Limits & cancelling?

Embed is included with Pro: 2,000 spins a month on one website (up to 3 domains), with a per-visitor daily limit you set. Need more? Embed Plus gives 50,000 spins a month for ฿149 in Thailand or $6.50 elsewhere, Pro included. Free 14-day trial first (Pro included, no card); cancel any time.

Read the developer docs →