Moevox API

What it does

The Moevox API lets you submit a research question with candidate options, then runs the full research pipeline for you:

• Analyze the question and optimize the options
• Design the audience filters and the questionnaire
• Sample synthetic respondents and collect answers
• Generate a public report with analysis and raw sample data

Each sampled respondent costs one credit. Your credit balance is checked before a report starts and the exact usage is returned with the result.

Choose how to integrate

Three ways to use the API — pick the one that fits your workflow.

• MCP — plug the research pipeline into Claude, Cursor, or ChatGPT with a one-line config. No code, no polling logic. Connect in minutes →
• AI Prompt — copy a ready-made prompt into any LLM chat (ChatGPT, Claude, Gemini…). Zero setup, works everywhere. Copy the prompt →
• REST API — call the endpoints directly with curl or your own code. Full control over the flow. Start here →

Endpoints at a glance

All endpoints require an API key via the Authorization header. See Authentication.

End-to-end flow

The pipeline takes a few minutes. The API uses an async pattern: you submit a report request, then poll for its status until it completes.

1. Create an API key in the research workspace under API keys.
2. Submit a report with POST /api/v1/reports — you receive a request_id.
3. Poll for status with GET /api/v1/reports/{request_id} until it returns completed.
4. Use the result — the response includes the report URL, the analysis JSON, the raw sample data, and the credits used.

First request

Here is the whole flow with curl. Replace moe_sk_live_… with your API key.

curl -X POST https://api.moevox.com/api/v1/reports \
  -H "Authorization: Bearer moe_sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Which pricing plan should we launch first?",
    "options": ["Monthly $29", "Monthly $49", "Annual $299"],
    "sample_size": 100,
    "language": "en"
  }'

{
  "request_id": "req_4f3a9c21e8b7d6c5",
  "status": "queued",
  "credits_estimated": 100,
  "credits_left": 900
}

curl https://api.moevox.com/api/v1/reports/req_4f3a9c21e8b7d6c5 \
  -H "Authorization: Bearer moe_sk_live_your_key_here"

Poll every 5 seconds while the questionnaire is being generated, then every 15 seconds during sampling (the longest stage). When the status becomes completed, the response embeds the full result.

Next steps

• MCP — connect Claude, Cursor, or ChatGPT with a one-line config
• AI Prompt — a ready-made prompt you can hand to any LLM
• Quickstart — a guided walkthrough
• Authentication — how API keys work
• API Reference — every endpoint with parameters and examples