FAQ

How long does a report take?

Usually a few minutes. Questionnaire generation takes 1–3 minutes; sampling is the longest stage and scales with sample_size. Questionnaire generation fails after 25 minutes if it does not complete; sampling has no hard timeout. Poll until the status becomes completed or failed.

Why is the API async instead of synchronous?

The pipeline runs dozens of AI calls per respondent. A synchronous response would time out on any real client. The async submit-and-poll pattern is the standard for this kind of API (see OpenAI Batch or HuggingFace Inference).

Do you support webhooks?

Not yet. Polling with GET /api/v1/reports/{request_id} is the supported pattern. If you build an SDK, the polling loop can be hidden inside a single await call. Webhooks may be added later — the polling endpoints will remain supported.

Are there rate limits?

Not yet. There are currently no rate limits on any endpoint. If limits are added later, they will be enforced per API key and documented here.

What are the respondents? Real people?

Respondents are synthetic personas sampled from demographic panels, answering through AI-simulated interviews. This makes research fast and repeatable. The methodology is documented on the public report page.

Are generated reports public?

Yes. Every completed report gets a public report_url that anyone with the link can view. Do not submit proprietary information you need to keep private.

Which languages are supported?

en, es, and zh. Defaults to en when omitted.

What happens if sampling fails halfway?

You are only charged for successful respondents. Unused reserved credits are released automatically, and the report ends in failed with an error message.

Can I see a report before spending credits?

There is no free preview. The credit check happens at submission, so an insufficient balance never starts work. Once started, the full result — report URL, analysis JSON, and raw sample data — is always returned.

How do I get more credits?

Buy credit packs in the research workspace under Buy credits. Packs are one-time purchases and never expire.

Is my API key stored in plaintext?

No. We store only a SHA-256 hash. The full key is shown once at creation and cannot be recovered later — if you lose it, revoke it and create a new one.