BlackBook Quiz API

Control panel — sign in with an admin API key

Session lasts 3 hours. Keys are managed here and via POST /api/v1/admin/keys.

BlackBook Quiz API —

Decision breakdown (all runs)

Latest runs

Click a row for the full flow log
Async checks — submit and poll (the API client pattern). Queued tasks start FIFO when a worker slot frees up. Click a row for details.
Sessions expire 3h after login. Revoking kills the token immediately.

Quiz proxy

Applies to new runs immediately — no restart. Persisted in the DB (overrides the BBK_QUIZ_PROXY env).

Supported schemes: socks5, socks5h, socks4, socks4a, http, https. Per-request override is also available via the proxy field of POST /api/v1/quiz. The service never silently bypasses the proxy — a dead proxy fails the run with "Proxy startup probe failed".

Result cache

Each person is checked once — conclusive decisions are kept forever and every re-check is served from the cache instantly (no new lead mints). force_refresh: true on a request re-runs and re-seeds that person.

Run