The wheel data, as JSON

Endpoints

Both respond with content-type: application/json and access-control-allow-origin: *. Both are static files on a CDN, so they are fast and there is nothing to take down.

The shape of a wheel

{
  "slug": "what-to-eat",
  "title": "What Should I Eat Wheel",
  "description": "...",
  "category": "food",
  "entries": ["Pizza", "Tacos", "..."],
  "entryCount": 10,
  "chancePerSpin": 0.1,
  "url": "https://spinpicker.io/wheel/what-to-eat",
  "embedUrl": "https://spinpicker.io/embed/wheel/what-to-eat",
  "updatedAt": "2026-08-05"
}

chancePerSpin is 1 divided by entryCount, rounded to six decimal places. It is included so the arithmetic is stated rather than assumed; the fairness page covers how the draw actually achieves it.

Examples

curl

curl -s https://spinpicker.io/api/wheels.json

JavaScript

const res = await fetch("https://spinpicker.io/api/wheels.json");
const data = await res.json();

// Every wheel with fewer than ten slices
const small = data.wheels.filter((w) => w.entryCount < 10);
console.log(small.map((w) => `${w.title}: ${w.entryCount} slices`));

Python

import json, urllib.request

with urllib.request.urlopen("https://spinpicker.io/api/wheels.json") as r:
    data = json.load(r)

for wheel in data["wheels"]:
    print(wheel["slug"], wheel["entryCount"], wheel["chancePerSpin"])

Licence

Creative Commons Attribution 4.0 International (CC-BY-4.0). Use it, change it, ship it in a commercial product, all fine. The one requirement is credit:

Wheel data from SpinPicker (https://spinpicker.io), CC BY 4.0

Full licence text at https://creativecommons.org/licenses/by/4.0/.

Stability

Fields will be added, not renamed or removed. If that ever has to change, it goes in the changelog with a date. The dataset is small and hand-maintained on purpose, so it does not churn.

Frequently asked questions