API Keys

Why use a key?

• Higher rate limit than the anonymous 5 req/min.
• Scans attached to your account — show up in your scan history and respect your public/private setting.
• Future write access to per-account features as they ship.

Create a key

1. Sign in (free account; takes a few seconds).
2. Open your Profile and find the API Keys section.
3. Click Create key, give it a name (e.g. "ci-bot"), and copy the value. You'll only see it once.

The key looks like aisk_…. Treat it like a password — don't commit it.

Use a key

Pass the key as an Authorization: Bearer header on any /api/public/scan call:

curl -X POST https://aiscan.site/api/public/scan \
  -H 'Authorization: Bearer aisk_…' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com"}'

Authenticated scans are attached to your account and follow your default visibility (public or private). Override per-call by adding "isPublic": false in the body.

Rotate & revoke

From the API Keys section of your Profile you can revoke a key instantly — the next request with that key returns 401. Create a new key alongside and migrate clients before deleting the old one.