Winnow API — Documentation

Winnow scores a single survey response for quality and fraud — bots, speeders, straight-liners, duplicates — using deterministic rules. No AI. Send one response with its answers and timing; get back a quality score (0–100), a recommendation and the exact flags.

Base URL

https://api.licrat.com/v1

Authentication

Send your API key as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Example: score a response

curl -X POST https://api.licrat.com/v1/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "response_id": "resp_demo_001",
    "duration_seconds": 240,
    "survey": { "min_expected_seconds": 60 },
    "answers": [
      { "question_id": "q1", "type": "single", "value": "Yes", "seconds_spent": 12 },
      { "question_id": "q2", "type": "open_text", "value": "Useful and easy to use.", "seconds_spent": 30 }
    ]
  }'

How do I get a key?

Keys are issued by hand during early access. Request one from the landing: