Build into Your Agent

One endpoint. Real human insights. Ship it today.

Ground your agent in real human data — not LLM hallucinations. OriginalVoices gives your agent access to 20,000+ Digital Twins of real people through a single API call.

Quick Example

import { OriginalVoices } from "originalvoices";

const client = new OriginalVoices();

const { data } = await client.ask.open({
  audiencePrompt: "US, 25-45, tech professionals",
  question: "What frustrates you most about project management tools?",
});

// data.answers = [{ answer: "...", confidence: 0.95 }, ...]

That's the entire integration. One endpoint, real answers from real people.

Installation

npm install originalvoices

Authentication

Get your API key from platform.originalvoices.ai. Set it as an environment variable:

ORIGINALVOICES_API_KEY=your_api_key_here

The client reads ORIGINALVOICES_API_KEY automatically — no config needed:

const client = new OriginalVoices(); // picks up env var

Two Question Types

Open-ended — ask.open()

Get raw answers from Digital Twins. Best for exploratory research, message testing, and understanding why.

const { data } = await client.ask.open({
  audiencePrompt: "UK, 18-30, fitness enthusiasts",
  question: "When purchasing running shoes, what's most important to you?",
});
// data.answers → [{ answer: "Comfort and support...", confidence: 0.92 }, ...]

Multiple choice — ask.choices()

Get quantitative breakdowns. Best for feature prioritization, A/B testing, and measurable preferences.

const { data } = await client.ask.choices({
  audiencePrompt: "US, 25-45, tech professionals",
  question: "Which is most important when buying running shoes?",
  choices: ["Price", "Comfort", "Style", "Durability"],
  isMultipleChoice: false,
});
// data.choices → [{ choice: "Comfort", percentage: 42 }, ...]

Rate Limits

• 60 requests per minute / 10,000 requests per day
• Check X-RateLimit-Remaining header to stay within limits
• For higher limits: support@originalvoices.ai

Next Steps

• API Reference — full endpoint documentation
• AI SDK — Vercel AI SDK tool for Next.js/Node.js
• Self-Hosted MCP Server — run OriginalVoices MCP in custom agent frameworks
• Question Guidelines — what types of questions work best