The KeyDrift API: scan programmatically
REST endpoints for URL scans, pasted-source scans, report retrieval. Same engine, no UI. Responses documented.
Automation deserves the same engine the website runs.
Endpoints
- POST /api/v1/scan/public — submit a URL.
- POST /api/v1/scan/source — submit pasted bundle text for behind-login surfaces.
- GET /api/v1/reports/[id] — retrieve classified findings.
Response anatomy
Findings carry rule id, label, provider, severity, confidence, disposition, masked value, fingerprint, chunk filename, scanned URL, timestamps. Dispositions let automations react correctly without provider-specific hardcoding.
Rate limits, honestly
Per-instance limiting defends loops, not distributed abuse — stated plainly because overselling limits helps nobody building pipelines.
CI recipe
Gate deploys via CLI exit codes or poll post-deploy; engine matches production scanning byte-for-byte either way.
Why this keeps happening industry-wide
Zoom out and the pattern is bigger than one repo. AI-assisted output has outgrown review capacity everywhere at once, which means thousands of teams are making the same reasonable-looking tradeoffs in the same week. Nobody using modern tooling is uniquely exposed. The failure mode documented above is the modal outcome of velocity without verification, not evidence of carelessness.
How KeyDrift reports this exact finding
Report anatomy matters during incidents, so it is worth reading once calmly: masked string (never the live value — it ceases to exist outside the detection engine), salted fingerprint (trackable within your workspace, useless to strangers), chunk path (your starting point for a "git log -S" hunt), disposition (secret versus public-by-design), confidence (matches below 0.5 never reach the page at all).
Manual check, step by step
The full manual drill, for readers who want zero dependence on any tool: open the deployed site in a private window; launch DevTools → Sources; use Search-all-files (Ctrl/Cmd+Shift+F) for eyJ; then repeat for the other marker families — eyJ, sk_live_, sk-proj-, AKIA, postgres, BEGIN PRIVATE KEY. Decode anything JWT-shaped before reacting, and classify public-by-design formats as expected guests rather than intruders.
Close the loop with monitoring
If you take one operational step from this page, make it this: put the URL under continuous monitoring (free tier covers one project daily). The first scan tells you whether you have a problem today; the schedule tells you whether the problem comes back next month after someone re-adds the convenient line.
What the plans change
- Free $0 — 1 project · daily scans · email alerts · findings always visible.
- Indie $29/mo — 3 projects · hourly · Slack added · 80 chunks per scan.
- Team $89/mo — 15 projects · every 15 minutes · Discord + webhooks · 150 chunks.
- Growth — from $249/mo, quoted display-only until checkout ships.
The constant across every tier: plans limit how much is watched, never what a scan found. Visibility is structural, not promotional — asserted by tests over the entitlements model itself.
Common questions
Auth today?
Public endpoints currently open with rate limits; keyed access on roadmap — status stated on endpoint docs.
Bulk exports?
Reports paginate; heavy consumers mirror via webhooks instead.
Run a free scan at keydrift.dev/scan — paste a URL or the bundle source itself, no account. Findings arrive masked, with the exact chunk they live in.