Domain Lab API Quick Start

Your monitored domains, scans, DNS records, events, and alerts — over a simple REST API

1

Create an API key

API access is included with every active subscription and trial. Go to Preferences → API and click Create API Key. Your key starts with dlb_ and is shown once — store it somewhere safe. You can revoke and rotate keys from the same page.

A key authenticates as you — it can only ever see and manage your own domains.

2

Make your first request

Every request is authenticated with a Bearer header. List your domains:

curl -H "Authorization: Bearer dlb_YOUR_KEY" \
  "https://www.domainlab.app/api/v1/domains?limit=10"

Each domain in the response includes its latest scan snapshot: registrar, SSL issuer and expiry, nameservers, security score, and precomputed days_until_domain_expires / days_until_ssl_expires fields (negative means already expired).

3

Explore the endpoints

EndpointWhat it does
GET /domainsAll your domains with latest scan snapshots
GET /domains/{id}One domain: full latest scan, DNS records, latest AI review
GET /domains/{id}/scanScan history for a domain, newest first
GET /domains/{id}/eventsChange events for a domain
GET /eventsChange events across all domains (filterable)
GET /alertsNotification history — what was sent, where, and when
POST /domainsStart monitoring a new domain (first scan queued automatically)
PATCH /domains/{id}Update frequency, notifications, or monitoring on/off
DELETE /domains/{id}Stop monitoring and remove a domain and all its history

The full machine-readable spec lives at /api/v1/openapi.json (OpenAPI 3.1) — importable directly into Postman, OpenAI GPT Actions, and most API tooling.

4

Know your limits

  • 120 requests/minute and 50,000 requests/month (adding a domain counts as 5)
  • Every response carries X-RateLimit-Remaining-Minute and X-RateLimit-Remaining-Month headers
  • On 429, wait for the Retry-After seconds before retrying
  • Live usage is shown in Preferences → API

Connecting an AI assistant?

Give Claude, ChatGPT, Hermes, OpenClaw, or any agent runtime live access to your domain portfolio with a single copy-paste prompt.

AI Agent Integration Guide