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.

Need a faster run? Submit with no_open_text: true to skip open-text questions — sampling then runs two calls per respondent instead of three and the report omits open-text themes. For the fastest run, submit with fast_questionnaire: true: the questionnaire keeps only the fixed core questions and sampling skips the extra respondent-profile enrichment call. See Create Report.

Choose how to integrate

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

• 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",
    "no_open_text": false,
    "fast_questionnaire": false
  }'

{
  "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

• 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