DomainScan API Quickstart

The DomainScan API gives you programmatic access to the same data powering 50+ web tools — domain lookups, DNS queries, IP intelligence, SSL checks, email authentication, and more. All responses are structured JSON, and most endpoints return results in under 2 seconds.

Base URL

https://api.domainscan.in/api/v1

All endpoints are HTTPS only. HTTP requests are redirected.

Authentication

Include your API key in every request as a header:

X-API-Key: your_api_key_here

Get your API key from your DomainScan account dashboard → Profile → API Keys.

Your First Request

curl

curl -X GET \
  "https://api.domainscan.in/api/v1/domain/lookup?domain=example.com" \
  -H "X-API-Key: your_api_key_here"

JavaScript (fetch)

const response = await fetch(
  'https://api.domainscan.in/api/v1/domain/lookup?domain=example.com',
  {
    headers: {
      'X-API-Key': 'your_api_key_here',
    },
  }
);
const { data } = await response.json();
console.log(data.domain, data.registrar, data.expiryDate);

Python

import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.domainscan.in/api/v1'

def lookup_domain(domain):
    resp = requests.get(
        f'{BASE_URL}/domain/lookup',
        params={'domain': domain},
        headers={'X-API-Key': API_KEY},
        timeout=10
    )
    resp.raise_for_status()
    return resp.json()['data']

info = lookup_domain('example.com')
print(info['registrar'], info['expiryDate'])

Response Structure

All responses use this envelope:

{
  "success": true,
  "data": {
    // endpoint-specific payload
  }
}

Error responses:

{
  "success": false,
  "message": "Domain not found or invalid",
  "code": "DOMAIN_NOT_FOUND"
}

Always check success before accessing data.

Core Endpoints

Domain Lookup (WHOIS / RDAP)

GET /domain/lookup?domain={domain}

Returns ownership, registration dates, registrar, nameservers, domain age, and Trust Score.

{
  "success": true,
  "data": {
    "domain": "example.com",
    "registrar": "ICANN Accredited Registrar",
    "registeredOn": "1995-08-14T00:00:00Z",
    "expiresOn": "2026-08-13T00:00:00Z",
    "updatedOn": "2024-08-14T00:00:00Z",
    "domainAge": "29 years",
    "nameservers": ["a.iana-servers.net", "b.iana-servers.net"],
    "status": ["clientDeleteProhibited", "clientTransferProhibited"],
    "trustScore": 92
  }
}

DNS Query

GET /domain/dns?domain={domain}&type={type}

type can be: A, AAAA, MX, TXT, CNAME, NS, SOA, CAA, SRV, or ALL

{
  "success": true,
  "data": {
    "domain": "example.com",
    "records": {
      "A": [{ "value": "93.184.216.34", "ttl": 3600 }],
      "MX": [{ "value": "mail.example.com", "priority": 10, "ttl": 3600 }]
    }
  }
}

IP Lookup

GET /ip/lookup?ip={ip}

Returns geolocation, ISP, ASN, hostname, reverse DNS, and Trust Score for any IPv4 or IPv6 address.

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "hostname": "dns.google",
    "org": "GOOGLE",
    "asn": "AS15169",
    "country": "United States",
    "city": "Mountain View",
    "lat": 37.386,
    "lon": -122.0838,
    "trustScore": 98
  }
}

SSL Certificate Check

GET /security/ssl-info?domain={domain}

Returns certificate details, validity, trust chain, grade, and security configuration.

{
  "success": true,
  "data": {
    "domain": "example.com",
    "valid": true,
    "expiresOn": "2026-11-01T00:00:00Z",
    "daysUntilExpiry": 72,
    "issuer": "DigiCert Inc",
    "certType": "OV",
    "grade": "A+",
    "protocols": ["TLSv1.2", "TLSv1.3"],
    "hsts": true
  }
}

Email Authentication Check

GET /security/email?domain={domain}

Returns SPF, DKIM, DMARC, BIMI, MTA-STS, TLS-RPT analysis and a composite deliverability score.

{
  "success": true,
  "data": {
    "domain": "example.com",
    "deliverabilityScore": 87,
    "spf": {
      "present": true,
      "valid": true,
      "policy": "~all",
      "lookupCount": 4
    },
    "dmarc": {
      "present": true,
      "policy": "reject",
      "pct": 100,
      "rua": "[email protected]"
    },
    "dkim": {
      "present": true,
      "selectors": ["google", "s1"]
    }
  }
}

Domain Trust Score

GET /domain/trust?domain={domain}

Comprehensive domain health check — blacklists, DNS, SSL, email auth, traffic signals — returns a 0–100 Trust Score with per-category breakdown and AI recommendations.

IP Blacklist Check

GET /ip/blacklist?ip={ip}

Checks IP against 130+ DNSBL and reputation databases. Returns listed/clean status per list with impact level.

DNS Propagation

GET /domain/propagation?domain={domain}&type={type}

Checks DNS propagation from resolvers worldwide. Returns per-resolver results, global propagation percentage, and average response times.

Nameserver Lookup

GET /domain/ns?domain={domain}

Returns authoritative nameservers with health scores, response times, and propagation status.

Endpoint Reference

Error Codes

Rate Limits

Rate limits are applied per API key. Headers on every response tell you your current status:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1724234400

On 429, implement exponential backoff:

async function fetchWithBackoff(url, options, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(url, options);
    if (res.status !== 429) return res;
    const retryAfter = parseInt(res.headers.get('Retry-After') || '1', 10);
    await new Promise(r => setTimeout(r, retryAfter * 1000 * Math.pow(2, i)));
  }
  throw new Error('Rate limit retries exhausted');
}

Quick Integration Patterns

Check domain health before sending email

async function isDomainHealthy(domain) {
  const res = await fetch(
    `https://api.domainscan.in/api/v1/domain/trust?domain=${domain}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
  const { data } = await res.json();
  return data.trustScore >= 70;
}

Monitor SSL expiry across multiple domains

import requests
from datetime import datetime, timezone

def check_ssl_expiry(domains, api_key, warn_days=30):
    alerts = []
    for domain in domains:
        resp = requests.get(
            f'https://api.domainscan.in/api/v1/security/ssl-info',
            params={'domain': domain},
            headers={'X-API-Key': api_key}
        )
        data = resp.json().get('data', {})
        days = data.get('daysUntilExpiry', 999)
        if days < warn_days:
            alerts.append({'domain': domain, 'daysLeft': days})
    return alerts

Validate email sender domain

async function validateSenderDomain(domain) {
  const res = await fetch(
    `https://api.domainscan.in/api/v1/security/email?domain=${domain}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
  const { data } = await res.json();
  return {
    valid: data.deliverabilityScore >= 60,
    score: data.deliverabilityScore,
    hasDmarc: data.dmarc?.present,
    dmarcPolicy: data.dmarc?.policy,
  };
}

For questions or higher-volume access, contact DomainScan.