Run a representative synthetic study with one request. Get an API key →
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.
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"]
}'question — the question to ask (required)questionType — single_choice, yes_no, scale_1_5, scale_1_10, nps, open_textoptions — answer options (required for single_choice)market — ISO country code(s), e.g. US, SE, or globalsampleSize — respondents (capped by plan: Pro 500, Scale 2000)breakdownBy — segment dimensions, e.g. ["age_group","sex"]ageMin / ageMax / sex / audienceDescription — optional audience filters{
"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": [ … ]
}grounding.depth tells you which).