CrawlCheck Monitor API

The Monitor API from CrawlCheck — 1 operation(s) for monitor.

GitHub OpenAPI

Operations 2

GET /api/v1/monitor/infrastructure Infrastructure monitor for one domain (?domain=): DNS (nameservers, MX, CAA… #
POST /api/v1/monitor/infrastructure Read the infrastructure now (licence holder for the domain or owner; at most… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/crawlcheck-io:crawlcheck-io-monitor-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

crawlcheck-io-monitor-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Crawlcheck Io Monitor API
  version: '1'
  contact:
    name: CrawlCheck
    url: https://crawlcheck.io/policy
    email: hello@crawlcheck.io
  license:
    name: Terms
    url: https://crawlcheck.io/policy
  x-core-contract:
    promise: 'These operations are the core contract. They stay at /api/v1 and keep answering for at least 180 days after any /api/v2 is announced; their stable fields change only in a new major version, and their provisional fields only after 30 days'' notice, per /docs/api/compatibility. Verifying what they return needs none of these calls: crawlcheck-verify.mjs checks a document on your machine against the published keys (/.well-known/http-message-signatures-directory) and the rotation record, read once with --online or saved for --keys. Everything else documented here is useful but secondary, and may change with the notice its fields'' tags promise.'
    operations:
    - method: GET
      path: /api/v1/resolve
      operationId: resolveDomainV1
    - method: POST
      path: /api/v1/resolve
      operationId: resolveBatchV1
    - method: POST
      path: /api/v1/preflight
      operationId: preflightV1
    - method: GET
      path: /api/v1/decisions/{sha256}
      operationId: decisionCheckV1
    - method: GET
      path: /api/v1/revocations
      operationId: revocations
    - method: GET
      path: /api/v1/visitor
      operationId: visitorResolveV1
    - method: POST
      path: /api/v1/visitor
      operationId: visitorResolveBatchV1
    - method: GET
      path: /api/v1/mcp/scan
      operationId: mcpScanUrl
    - method: POST
      path: /api/v1/mcp/lock/check
      operationId: mcpLockCheck
    list: https://crawlcheck.io/api/v1/core
  description: 'Operations tagged Monitor across 2 of this provider''s published API definitions: crawlcheck-io-openapi.json, crawlcheck-io-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://crawlcheck.io
tags:
- name: Monitor
paths:
  /api/v1/monitor/infrastructure:
    get:
      operationId: infrastructureMonitor
      summary: 'Infrastructure monitor for one domain (?domain=): DNS (nameservers, MX, CAA…'
      parameters:
      - name: domain
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: crawlcheck-infrastructure-monitor
          content:
            application/json:
              examples:
                worked:
                  summary: Shape; history goes to the licence holder.
                  value:
                    kind: crawlcheck-infrastructure-monitor
                    v: 1
                    domain: example-roofing.com
                    monitored: true
                    cadence: about every 4 hours
                    last_read: '2026-10-09T06:17:00Z'
                    confirmed_state:
                      at: '2026-10-09T06:17:00Z'
                      dns:
                        ns:
                        - ns1.example-dns.com
                        - ns2.example-dns.com
                        mx:
                        - 10 mx.example-mail.com
                        caa:
                        - 0 issue letsencrypt.org
                        ds: []
                        dmarc:
                        - p=quarantine
                        a:
                        - 203.0.113.10
                        aaaa: []
                      tls:
                        https: ok
                        cert:
                          issuer: Let's Encrypt
                          not_before: '2026-09-20T00:00:00Z'
                          not_after: '2026-12-19T00:00:00Z'
                          cert_sha256: 8cd7…
                        ct_read: true
                      redirects:
                        http: https://example-roofing.com/
                        https: https://example-roofing.com/
                        www: https://example-roofing.com/
                        https_status: 200
                        http_to_https: true
                        hops_https: 0
                        hsts: true
                      schema:
                        blocks: 2
                        invalid: 0
                        types:
                        - LocalBusiness
                        - WebSite
                        name: Example Roofing LLC
                        telephone: '3035550100'
                        url: https://example-roofing.com
                      capabilities:
                        agent_card:
                          present: false
                        mcp_server_card:
                          present: false
                        api_catalog:
                          present: false
                        skills_index:
                          present: false
                    awaiting_confirmation: null
                    changes: 0
                    rule: a change is reported only when two readings in a row agree on it; a field that could not be read keeps its last confirmed value; the first reading is the baseline
                    feed: https://crawlcheck.io/api/v1/changes?domain=example-roofing.com&section=infrastructure
                    signature:
                      v: 1
                      alg: Ed25519
                      kid: hcIAczGf…
              schema:
                type:
                - object
                - 'null'
                properties:
                  kind:
                    type:
                    - string
                    - 'null'
                  v:
                    type:
                    - number
                    - 'null'
                  domain:
                    type:
                    - string
                    - 'null'
                  monitored:
                    type:
                    - boolean
                    - 'null'
                  cadence:
                    type:
                    - string
                    - 'null'
                  last_read:
                    type:
                    - string
                    - 'null'
                  confirmed_state:
                    type:
                    - object
                    - 'null'
                    properties:
                      at:
                        type:
                        - string
                        - 'null'
                      dns:
                        type:
                        - object
                        - 'null'
                        properties:
                          ns:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          mx:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          caa:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          ds:
                            type:
                            - array
                            - 'null'
                            items: {}
                          dmarc:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          a:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          aaaa:
                            type:
                            - array
                            - 'null'
                            items: {}
                        additionalProperties: true
                      tls:
                        type:
                        - object
                        - 'null'
                        properties:
                          https:
                            type:
                            - string
                            - 'null'
                          cert:
                            type:
                            - object
                            - 'null'
                            properties:
                              issuer:
                                type:
                                - string
                                - 'null'
                              not_before:
                                type:
                                - string
                                - 'null'
                              not_after:
                                type:
                                - string
                                - 'null'
                              cert_sha256: {}
                            additionalProperties: true
                          ct_read:
                            type:
                            - boolean
                            - 'null'
                        additionalProperties: true
                      redirects:
                        type:
                        - object
                        - 'null'
                        properties:
                          http:
                            type:
                            - string
                            - 'null'
                          https:
                            type:
                            - string
                            - 'null'
                          www:
                            type:
                            - string
                            - 'null'
                          https_status:
                            type:
                            - number
                            - 'null'
                          http_to_https:
                            type:
                            - boolean
                            - 'null'
                          hops_https:
                            type:
                            - number
                            - 'null'
                          hsts:
                            type:
                            - boolean
                            - 'null'
                        additionalProperties: true
                      schema:
                        type:
                        - object
                        - 'null'
                        properties:
                          blocks:
                            type:
                            - number
                            - 'null'
                          invalid:
                            type:
                            - number
                            - 'null'
                          types:
                            type:
                            - array
                            - 'null'
                            items:
                              type:
                              - string
                              - 'null'
                          name:
                            type:
                            - string
                            - 'null'
                          telephone:
                            type:
                            - string
                            - 'null'
                          url:
                            type:
                            - string
                            - 'null'
                        additionalProperties: true
                      capabilities:
                        type:
                        - object
                        - 'null'
                        properties:
                          agent_card:
                            type:
                            - object
                            - 'null'
                            properties:
                              present:
                                type:
                                - boolean
                                - 'null'
                            additionalProperties: true
                          mcp_server_card:
                            type:
                            - object
                            - 'null'
                            properties:
                              present:
                                type:
                                - boolean
                                - 'null'
                            additionalProperties: true
                          api_catalog:
                            type:
                            - object
                            - 'null'
                            properties:
                              present:
                                type:
                                - boolean
                                - 'null'
                            additionalProperties: true
                          skills_index:
                            type:
                            - object
                            - 'null'
                            properties:
                              present:
                                type:
                                - boolean
                                - 'null'
                            additionalProperties: true
                        additionalProperties: true
                    additionalProperties: true
                  awaiting_confirmation: {}
                  changes:
                    type:
                    - number
                    - 'null'
                  rule:
                    type:
                    - string
                    - 'null'
                  feed:
                    type:
                    - string
                    - 'null'
                  signature:
                    type:
                    - object
                    - 'null'
                    properties:
                      v:
                        type:
                        - number
                        - 'null'
                      alg:
                        type:
                        - string
                        - 'null'
                      kid: {}
                    additionalProperties: true
                additionalProperties: true
                x-schema-source: worked-example
        '400':
          description: no or bad domain
      x-codeSamples:
      - lang: Shell
        label: curl
        source: curl -s 'https://crawlcheck.io/api/v1/monitor/infrastructure?domain=example-roofing.com'
      security: []
      x-auth: public; no credential read
      tags:
      - Monitor
    post:
      operationId: infrastructureMonitorRun
      summary: Read the infrastructure now (licence holder for the domain or owner; at most…
      parameters:
      - name: domain
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: crawlcheck-infrastructure-monitor with ran_now
          content:
            application/json:
              examples:
                worked:
                  summary: Shape.
                  value:
                    kind: crawlcheck-infrastructure-monitor
                    v: 1
                    domain: example-roofing.com
                    monitored: true
                    last_read: '2026-10-09T06:20:00Z'
                    changes: 1
                    history:
                    - domain: example-roofing.com
                      at: '2026-10-09T06:20:00Z'
                      section: infrastructure
                      kind: schema.identity_changed
                      severity: medium
                      detail: 'The business phone in the homepage structured data changed: 3035550100 -> 3035550199'
                      from: '3035550100'
                      to: '3035550199'
                      first_seen: '2026-10-09T02:17:00Z'
                    ran_now:
                      domain: example-roofing.com
                      at: '2026-10-09T06:20:00Z'
                      baseline: false
                      events: 1
                      pending: 0
              schema:
                type:
                - object
                - 'null'
                properties:
                  kind:
                    type:
                    - string
                    - 'null'
                  v:
                    type:
                    - number
                    - 'null'
                  domain:
                    type:
                    - string
                    - 'null'
                  monitored:
                    type:
                    - boolean
                    - 'null'
                  last_read:
                    type:
                    - string
                    - 'null'
                  changes:
                    type:
                    - number
                    - 'null'
                  history:
                    type:
                    - array
                    - 'null'
                    items:
                      type:
                      - object
                      - 'null'
                      properties:
                        domain:
                          type:
                          - string
                          - 'null'
                        at:
                          type:
                          - string
                          - 'null'
                        section:
                          type:
                          - string
                          - 'null'
                        kind:
                          type:
                          - string
                          - 'null'
                        severity:
                          type:
                          - string
                          - 'null'
                        detail:
                          type:
                          - string
                          - 'null'
                        from:
                          type:
                          - string
                          - 'null'
                        to:
                          type:
                          - string
                          - 'null'
                        first_seen:
                          type:
                          - string
                          - 'null'
                      additionalProperties: true
                  ran_now:
                    type:
                    - object
                    - 'null'
                    properties:
                      domain:
                        type:
                        - string
                        - 'null'
                      at:
                        type:
                        - string
                        - 'null'
                      baseline:
                        type:
                        - boolean
                        - 'null'
                      events:
                        type:
                        - number
                        - 'null'
                      pending:
                        type:
                        - number
                        - 'null'
                    additionalProperties: true
                additionalProperties: true
                x-schema-source: worked-example
        '401':
          description: no licence for this domain
        '409':
          description: not on an active licence
        '429':
          description: read less than 10 minutes ago
      x-codeSamples:
      - lang: Shell
        label: curl
        source: 'curl -s -X POST ''https://crawlcheck.io/api/v1/monitor/infrastructure?domain=example-roofing.com'' -H ''x-crawlcheck-key: $KEY'''
      security: []
      x-auth: public; no credential read
      x-crawlcheck-budget:
        request_body_max: 1048576
      tags:
      - Monitor
    servers:
    - url: https://crawlcheck.io
components:
  securitySchemes:
    licenceKey:
      type: apiKey
      in: header
      name: x-crawlcheck-key
      description: 'Your licence key: cc_ followed by 32 hex characters. Sent on every keyed call.'
    bearer:
      type: http
      scheme: bearer
      description: The same licence key as a Bearer token. Accepted on /api/v1/* and /api/usage.
externalDocs:
  url: https://crawlcheck.io/docs/api
  description: Human-readable reference
x-refined-from:
- crawlcheck-io-openapi.json
- crawlcheck-io-openapi.yml