API docs
Kernsignal API
Send a synthetic panel and, if you have it, the matching human data. Get back which questions you can use, which to spot-check and which to field with humans, plus a record you can show others.
Base URL: https://api.kernsignal.ai/v1
What you can do
| Goal | Start here |
|---|---|
| Run an audit end to end in the sandbox | Quickstart |
| Get and protect an API key | Authentication |
| Upload files, read results, download the report | Audits |
| Rank suspicious respondents in a tracking wave for human review | Bot screen |
| Show that an audit was run, with a badge and a signed record | Verification |
| Get a callback when an audit finishes | Webhooks |
| Handle failures | Errors |
| Use Python or plain fetch | SDKs and examples |
How the data is handled
- Uploaded files are processed in memory and are not stored. Only a SHA-256 hash of each file is kept, so a verification record can identify what was audited.
- Results stay in the live system for 30 days (24 hours for sandbox
ks_test_keys).DELETE /v1/audits/{id}removes a result from the live system immediately. Nightly backups hold results for up to 14 days after removal. Verification records persist until revoked. - The audit gives a ranking of how likely each question is to diverge from humans. It is not a probability and not a certification of a panel or its vendor.