---
title: "Scan a domain on the licensed lane (valid licence key required; 60 scans per ten minutes per key; 404 without a key)"
method: POST
path: "/api/scan/licensed"
---

# Scan a domain on the licensed lane (valid licence key required; 60 scans per ten minutes per key; 404 without a key)

`POST /api/scan/licensed`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/scan/licensed`
- Auth: one of:
  - API key in header `x-crawlcheck-key`
  - HTTP bearer

## Headers

- `x-crawlcheck-key` string, required

## Request body

- object
  - `domain` string, required

## Response `200`

The scan record, identical to /api/scan

- object, nullable
  - `id` string, nullable
  - `domain` string, nullable
  - `scanned_host` string, nullable
  - `scannedAt` string, nullable
  - `score_version` number, nullable
  - `grade` string, nullable
  - `overall` number, nullable
  - `grade_detail` object, nullable
    - `capped` boolean, nullable
    - `cap` unknown
    - `cap_reason` unknown
    - `unscored_affects_grade` boolean, nullable
    - `unscored` string[], nullable
  - `section_scores` object[], nullable
    - `id` string, nullable
    - `title` string, nullable
    - `score` number, nullable
  - `findings` unknown[], nullable
    - unknown
  - `checks` object[], nullable
    - `path` string, nullable
    - `status` number, nullable
    - `contentType` string, nullable
    - `bytes` number, nullable
    - `cacheControl` string, nullable
    - `cfCacheStatus` string, nullable
    - `ms` number, nullable
    - `excerpt` string, nullable
    - `sitemap_lines` string, nullable
    - `verdict` string, nullable
    - `cacheSplit` object, nullable
      - `bare_status` number, nullable
      - `fresh_status` number, nullable
      - `bare_html` boolean, nullable
      - `fresh_html` boolean, nullable
      - `bare_cf` string, nullable
      - `diverged` boolean, nullable
      - `bare_bytes` number, nullable
      - `fresh_bytes` number, nullable
  - `agentview` object, nullable
    - `rows` object[], nullable
      - `id` string, nullable
      - `label` string, nullable
      - `role` string, nullable
      - `status` number, nullable
      - `words` number, nullable
      - `xrobots` string, nullable
      - `redirected_to` string, nullable
      - `blocker` string, nullable
      - `vendor` string, nullable
      - `repro` string, nullable
      - `similarity` number, nullable
      - `cause` string, nullable
    - `deterministic` boolean, nullable
    - `self_similarity` number, nullable
    - `split` string, nullable
    - `split_evidence` unknown
    - `all_refused` boolean, nullable
    - `answer_word_share` number, nullable
    - `claims_unverified` boolean, nullable
    - `evidence` unknown[], nullable
      - unknown
    - `conflicts` unknown[], nullable
      - unknown
  - `confidence` object, nullable
    - `v` number, nullable
    - `sections_scored` object, nullable
      - `n` number, nullable
      - `of` number, nullable
      - `ratio` number, nullable
    - `identities_answered` object, nullable
      - `n` number, nullable
      - `of` number, nullable
      - `ratio` number, nullable
    - `fetches_kept` object, nullable
      - `n` number, nullable
      - `of` number, nullable
      - `ratio` unknown
    - `stage_failures` number, nullable
    - `non_observations` number, nullable
    - `non_observations_attempted` number, nullable
    - `vantages` number, nullable
    - `refused` boolean, nullable
    - `note` string, nullable
  - `self_audit` object, nullable
    - `checked` number, nullable
    - `findings` number, nullable
    - `worst` number, nullable
  - `proof_overall` number, nullable

## Other responses

- `404`: No valid licence key
- `429`: Key allowance used for this ten-minute window

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)