API Documentation - Whose.Domains Developer API

Whose.Domains

📘 API Documentation

Free RESTful APIs for domain research. Access WHOIS data, DNS records, domain scoring, and more programmatically.

Base URL: https://whose.domains
Rate Limit: 5-10 requests per minute per IP (varies by endpoint)
Format: All responses are JSON

Endpoints

🔍 Domain Lookup
📊 Domain Health Score
🆚 WHOIS Compare
🔗 Related Domains
🌐 DNS Analysis
🔬 Domain Analysis (SEO, Security, Technical)
📜 WHOIS History & Diff
📥 Domain Report Export
⏰ Expiring Domains
🖥️ Reverse IP Lookup
📦 Bulk Domain Search

🔍 Domain Lookup

            POST
            /domain/{domainName}/search
        

Looks up domain WHOIS information. Triggers a fresh WHOIS query if data is not cached. Returns RDAP URL if applicable.

Path Parameter: domainName - Full domain name (e.g., example.com)
Response: {"code":0, "data": {"rdapUrl": "..."}} on success

📊 Domain Health Score

            GET
            /api/tools/score/{domainName}
        

Comprehensive domain health scoring (0-100) with grade (A+ to F). Evaluates SSL, DNS, email security (SPF/DKIM/DMARC), security headers, and domain age.

This endpoint requires a page session token and can only be used from the Domain Health Score tool page.

Response fields: totalScore, grade, categories (each with score and recommendations)

🆚 WHOIS Compare

            GET
            /api/tools/compare?domain1={d1}&domain2={d2}
        

Compare two domains side by side — registration data, DNS, ownership. Includes a similarity score (0-100) indicating likelihood of same ownership.

Parameters: domain1, domain2
Response: Profiles for both domains, field-by-field differences, similarity score

🌐 DNS Analysis

            GET
            /api/tools/dns-analyze/{domainName}
        

Deep DNS analysis: NS, A, AAAA, MX, TXT, SOA, CNAME records. Also checks SPF, DMARC, DKIM and detects configuration issues.

🔬 Domain Analysis

            GET
            /api/tools/analyze/{domainName}
        

Full domain analysis including technical metrics (response time, SSL, server software, open ports), SEO analysis (title, meta, headings, links, Open Graph), and security assessment (security headers, security.txt, SSL details).

📜 WHOIS History & Diff

These endpoints require a page session token and can only be used from the WHOIS History tool page.

            GET
            /api/domain-history/snapshots/{domainName}
        

List all WHOIS snapshots for a domain.

            GET
            /api/domain-history/diff?id1={id1}&id2={id2}
        

Compare two WHOIS snapshots and see field-by-field changes.

            GET
            /api/domain-history/latest-diff/{domainName}
        

Automatically compare the two most recent snapshots of a domain.

📥 Domain Report Export

            GET
            /api/domain-report/{domainName}
        

Download a comprehensive JSON report including WHOIS, registrant, DNS records, subdomains, and WHOIS history snapshots.

This endpoint requires a page session token and can only be used from the domain detail page's "Export Report" button.

⏰ Expiring Domains

            GET
            /api/expiring-domains?days={days}&page={page}&tld={tld}
        

List domains expiring within a specified number of days. Supports TLD filtering and pagination.

Parameters: days (1-365, default 30), page (default 1), tld (optional, e.g. "com")

🖥️ Reverse IP Lookup

            GET
            /api/tools/reverse-ip/{ip}?page={page}
        

Find all domains hosted on a given IPv4 address. Includes GeoIP and ASN information.

📦 Bulk Domain Search

            POST
            /api/tools/bulk-search
        

Check up to 100 domains at once for availability, WHOIS info, or DNS status.

Request Body (JSON):
{"domains": ["example.com", "test.org"], "searchType": "availability"}
searchType options: availability, whois, dns

Response Format

All API responses follow this structure:

{
  "code": 0,       // 0 = success, 400 = error
  "msg": "...",     // Error message (if any)
  "data": { ... }   // Response payload
}