Digital Twins
Digital twins are AI-powered representations of real demographic personas. Each twin has a distinct personality, background, and perspective grounded in demographic survey data. You can chat with them individually, run group surveys, and get aggregated insights.
Use Cases
- Market Research — Ask target demographics about products, messaging, or campaigns before launching
- Content Testing — Get feedback on content from specific audience segments
- Product Development — Understand pain points and needs of different user groups
- Campaign Planning — Test messaging with different demographic groups
Concepts
Static Groups
Pre-built demographic groups provided by neuroflash:
| Group Key | Label | Description |
|---|---|---|
gen_z | Gen Z | Born 1997-2012 |
millennials | Millennials | Born 1981-1996 |
gen_x | Generation X | Born 1965-1980 |
baby_boomers | Baby Boomers | Born 1946-1964 |
gen_alpha | Generation Alpha | Born 2010+ |
Each group contains multiple individual twins with unique names, ages, locations, jobs, and personalities.
Twins
Individual digital personas within a group. Each twin has:
- Name, age, gender, location — Demographic attributes
- Job title — Professional background
- Self-description — How the twin describes themselves
- Avatar — Generated profile image
Verbalized Sampling
When enabled (default), each twin generates 5 probability-weighted candidate responses and selects the most representative one. This produces more consistent and reliable answers compared to a single generation.
Structured Output
You can provide a custom JSON schema to get structured responses instead of free-text. This is useful for quantitative analysis across many twins.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/static-groups | List all static demographic groups |
GET | /v1/workspaces/{id}/static-groups/{key}/twins | List twins in a group |
GET | /v1/workspaces/{id}/twins/{twinId} | Get a single twin |
POST | /v1/workspaces/{id}/twins/{twinId}/chat-completions | Chat with a single twin |
POST | /v1/workspaces/{id}/twin-group-chat-completions | Group chat (multi-turn) |
POST | /v1/workspaces/{id}/twin-group-chat-opinions | Get group opinions |
GET | /v1/workspaces/{id}/reactions | List reactions |
GET | /v1/workspaces/{id}/reactions/{id}/sources | Get reaction news sources |
All endpoints use the base path: https://app.neuroflash.com/api/digital-twin-service