Website Security Scanner API

Endpoint

POST https://nesqualtech.com/api/v1/security-scan

Send a JSON body with a single domain field. The scanner performs live, read-only DNS and HTTPS checks against that domain. Only scan domains you own or are authorized to test. The endpoint accepts cross-origin requests (CORS), so it can be called directly from browsers and agents.

Authentication

Every request must include your API key, either as a bearer token or an x-api-key header:

Authorization: Bearer nsk_your_api_key
# — or —
x-api-key: nsk_your_api_key

Keys start with nsk_ and are created and revoked from API keys in your dashboard settings. A key is shown once, when it is created — we store only a hash of it, so it cannot be retrieved afterwards by you or by us. Keep it secret and treat it like a password. A missing, expired or revoked key returns 401; revocation takes effect immediately.

Rate limits

Requests are rate limited per API key. When you exceed the limit the API responds with 429 Too Many Requests and a Retry-After header. Successful responses include X-RateLimit-Remaining and X-RateLimit-Reset headers so you can pace your requests.

Example request

curl -X POST https://nesqualtech.com/api/v1/security-scan \
  -H "Authorization: Bearer nsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Example response

{
  "domain": "example.com",
  "grade": "B",
  "score": 82,
  "findings": [
    {
      "id": "https",
      "title": "HTTPS enforced",
      "category": "transport",
      "status": "pass",
      "detail": "Site redirects HTTP to HTTPS."
    },
    {
      "id": "hsts",
      "title": "HSTS header",
      "category": "transport",
      "status": "warn",
      "detail": "Strict-Transport-Security missing max-age."
    }
  ],
  "resultUrl": "https://nesqualtech.com/security-scan/ab12cd34ef56"
}

• grade — overall letter grade, A through F.
• score — numeric score from 0 to 100.
• findings — array of individual checks, each with an id, title, category, and status (pass, warn, or fail).
• resultUrl — link to a shareable, human-readable result page for this scan.

Error responses