Oracle API

The preference layer for autonomous agents.

AI agents need consumer understanding at decision time. The Oracle API returns probability-weighted preference distributions in milliseconds — so autonomous systems can make informed choices without waiting for research.

// Agent encounters: "Plan a birthday
// party for my 7yo, budget $150"

// Oracle returns preference distributions:

{
  "Food & Cake":       0.35,
  "Entertainment":     0.25,
  "Decorations":       0.18,
  "Party Favors":      0.12,
  "Themed Supplies":   0.10,
  "latency_ms":        187
}
200ms
Average API response
3
Domain-specific models
10+
Demographic dimensions
KL ≈ 0.08
Typical divergence from live panels
Agentic Commerce

Agents decide in milliseconds. Research takes weeks.

Autonomous commerce agents — shopping assistants, recommendation engines, personalization systems — make thousands of consumer-facing decisions per second. Each decision requires an understanding of what people actually want. The Oracle provides that understanding on demand.

  • Sub-second response time at production scale
  • Returns probability distributions for nuanced decision-making
  • Unlimited scenario coverage for edge cases and niche segments
  • No pre-computation required — query any demographic in real time
  • Validated against live panel data (KL typically 0.05–0.09)
Read the CTO Brief →
// Oracle API Request

POST /api/oracle/query

{
  "question": "meal planning priorities",
  "demographics": {
    "age": "25-34",
    "income": "$50K-$75K",
    "location": "suburban"
  },
  "model": "consumer"
}
Integration patterns

Three ways to integrate.

From development-time calibration to live runtime queries.

1

Training-Time Calibration

Pre-compute preference distributions during development. Bake consumer understanding into agent logic as calibrated parameters.

2

Pre-Deployment Simulation

Test proposed agent logic against synthetic populations before release. Measure predicted satisfaction and conversion across segments.

3

Runtime Oracle Queries

Agents query The Oracle directly when encountering novel scenarios outside pre-calibrated knowledge. Real-time preference data on demand.

Domain models

Three models. Instant expertise.

Each model is trained on validated domain-specific data and returns calibrated preference distributions.

Consumer

Shopping behavior, brand preferences, lifestyle decisions, budget allocation. Validated against tier-one consumer panels.

Brand Preference Purchase Intent Lifestyle Budget

Healthcare (HCP)

Physician perspectives, prescribing behavior, treatment preferences. 15 medical specialties from primary care to oncology.

Prescribing Treatment 15 Specialties

Social

Attitudes, values, political opinions, social trends. Demographic and geographic structure validated against major polls.

Public Opinion Policy Social Trends
Under the hood

Predictions, not surveys.

The Oracle uses fine-tuned language models trained on millions of real survey responses to predict how demographic segments would respond to any question.

  • Returns probability distributions, not single answers
  • Filter by demographics: age, income, gender, education, location, and more
  • Three query modes: structured, natural language, or raw prompt
  • Conditional querying: "Given they answered X, how would they answer Y?"
  • Validated against live panel data across all domains
// Single Query Request

POST /api/oracle/chat

{
  "question": "Which factor matters most when choosing a grocery store?",
  "options": [
    "Price",
    "Proximity",
    "Product Quality",
    "Brand Selection"
  ],
  "demographics": {
    "age": "25-34",
    "income": "$50K-$75K",
    "location": "suburban"
  },
  "model": "consumer"
}
Also for researchers

A dashboard for humans, too.

The Oracle isn't just an API. Researchers and product teams can query it directly through the Simsurveys dashboard.

Single Query

Ask any research question and get predicted response distributions in seconds. Manual, AI-assisted, or raw input modes.

Crosstab Analysis

Run batch queries across multiple demographic segments simultaneously. Compare responses across banners in seconds, not weeks.

Conditional Querying

Condition predictions on prior response history. "Given they answered X, how would they answer Y?" Layer demographics with conditioning.

Give your agents consumer intelligence.

Embed validated preference data into any autonomous system. Start querying in minutes.