Quickstart

1. Set your base URL and key

BASE=https://mavera-platform.vercel.app
MAVERA_API_KEY=mav_your_key_here

No key yet? See API keys & admin to mint one. Running locally with no database? The API runs in demo mode — no key required.

2. Build an audience

Turn a connected data source into a synthetic panel:

curl -s -X POST $BASE/api/v1/audiences \
  -H "x-api-key: $MAVERA_API_KEY" -H 'content-type: application/json' \
  -d '{"sourceIds":["src_cadence_stripe"],"projectIds":["proj_demo"],"targetSize":200}'
# → { ok:true, data:{ audience:"aud_f1_1", derived:{ recordCount, dimensions:[...] } } }

3. Talk to it

Send a message; keep the returned chatId and pass it back each turn for memory:

curl -s -X POST $BASE/api/v1/chat \
  -H "x-api-key: $MAVERA_API_KEY" -H 'content-type: application/json' \
  -d '{"audienceId":"aud_f1_1","message":"How do you handle bookkeeping today?","verbosity":"terse"}'
# → { ok:true, data:{ chatId:"chat_abc", reply:{ content:"...", abstained:false }, honesty:{...} } }

4. Run a focus group

curl -s -X POST $BASE/api/v1/tools/focus_group \
  -H "x-api-key: $MAVERA_API_KEY" -H 'content-type: application/json' \
  -d '{"audienceId":"aud_f1_1","panelSize":5,"rounds":2,
       "topic":"A $29/mo all-in-one finance app",
       "stimulus":"Bookkeeping, invoicing, and forecasting in one place for $29/mo.",
       "moderatorGuide":["Gut reaction?","What would stop you from buying?"]}'

5. Mine the transcript

curl -s -X POST $BASE/api/v1/tools/mine_insights \
  -H "x-api-key: $MAVERA_API_KEY" -H 'content-type: application/json' \
  -d '{"turns":[{"speaker":"Jamie","text":"At $29 I would switch today"},
                {"speaker":"Riley","text":"Too cheap — worried it will not scale"}],
       "useLlm":true,"llmMode":"identify"}'

Every call returns the standard envelope and (for keyed calls) X-RateLimit-* + X-Credits-Used headers. See Errors, limits & headers.

1. Set your base URL and key

2. Build an audience

3. Talk to it

4. Run a focus group

5. Mine the transcript

On this page