API

Run a representative synthetic study with one request. Get an API key →

Authentication

Create a key on the API keys page (Pro or Scale plan) and pass it as a bearer token. Keys are shown once — store them securely.

Run a study

POST /api/v1/simulate

curl https://synthetic-audience.noniner.io/api/v1/simulate \
  -H "Authorization: Bearer sa_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "question": "How likely would you be to try a new oat-milk energy drink?",
    "questionType": "single_choice",
    "options": ["Very likely", "Somewhat likely", "Unlikely"],
    "market": "US",
    "sampleSize": 200,
    "breakdownBy": ["age_group", "sex"]
  }'

Request fields

Response

{
  "studyId": "…",
  "report": {
    "topline": { "answer": "Unlikely", "share": 0.48, "marginOfError": 0.07 },
    "distribution": [ … ],
    "segments": [ … ],
    "grounding": { "provider": "US Census ACS PUMS", "depth": "microdata" },
    "confidence": { "level": "moderate", "notes": [ … ] }
  },
  "respondents": [ … ]
}

Notes