Developer Reference

Credits & Pricing

Every API call costs credits. You get 10,000 free credits per month (resets on the 1st). Need more? Purchase credit packs starting at €9 for 50,000 credits.

Credits & Pricing

Every API call costs credits. You get 10,000 free credits per month (resets on the 1st). Need more? Purchase credit packs starting at €9 for 50,000 credits.

Credits per Endpoint

Find common endpoint costs below. Some reference endpoints are free. For the complete, machine-readable rate card, use /v1/pricing.

EndpointCreditsDescription
/v1/coverage 0 List supported TLDs
/v1/tlds 0 TLD metadata list
/v1/watchlist 1 View your watchlist
/v1/status 1 Check domain availability
/v1/health/quick 1 Quick health check
/v1/dns 1 DNS lookup
/v1/dns/bulk 1/domain Bulk DNS lookup (up to 25 domains)
/v1/ip 1 IP geolocation
/v1/value 2 Domain valuation
/v1/prices 1 Registration prices
/v1/tlds/:tld 1 TLD details
/v1/watchlist/check 1 Check watchlist item
/v1/typos/permutations 1 Typo permutations
/v1/typos/score 1 Typo risk score
/v1/email/check 1 Email blacklist check
/v1/status/bulk 1/domain Bulk availability (up to 50 TLDs)
/v1/health 3 Full health check
/v1/dns/all 2 All DNS records
/v1/profile 3 Domain profile
/v1/redirects 2 Redirect chain
/v1/tech 3 Tech stack detection
/v1/categorize 3 Website categorization
/v1/similarity 2 Domain similarity
/v1/typos 2-3 Typosquatting detection
/v1/reputation 3 Domain reputation
/v1/reputation/bulk 3/domain Bulk domain reputation (up to 3 domains)
/v1/certificates 2 SSL certificate
/v1/certificates/bulk 2/domain SSL certificate
/v1/social 2 Social handle check
/v1/social/bulk 2/handle Bulk Social Handle Check
/v1/company 3 Company lookup
/v1/suggest 2-5 Domain suggestions
/v1/whois 3 WHOIS lookup
/v1/whois/history 3 WHOIS change history
/v1/whois/bulk 3/domain Bulk WHOIS lookup (up to 20 domains)
/v1/rdap/bulk 2/query WHOIS lookup
/v1/prices/bulk 1/TLD Bulk pricing
/v1/dns/security 3 DNS security analysis
/v1/dns/propagation 2 DNS resolver comparison
/v1/dns/propagation/bulk 2/domain DNS resolver comparison
/v1/email-auth/bulk 3/domain Email authentication
/v1/hosting/bulk 3/domain Hosting detection
/v1/value/bulk 2/domain Bulk valuation
/v1/health/bulk 3/domain Bulk health check
/v1/subdomains 4-5 Subdomain finder
/v1/subdomains/bulk 4-5/domain Subdomain finder
/v1/report 5 Comprehensive report (saves ~10 credits vs individual calls)

Credit Enforcement

When your credits reach zero, API requests that cost credits return HTTP 402 (Payment Required). Free browser-based tools are not affected.

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

To restore access: purchase credits at the subscription page, enable auto-recharge, or wait for your monthly reset on the 1st of each month.

Credit Response Headers

All authenticated API responses include an X-Credits-Remaining header showing your current credit balance after the request.

X-Credits-Remaining: 9500

Credit Calculator

Estimate your credit usage for bulk operations:

Total Credits Needed
100
That's 1% of your free monthly credits

Credit Packs

Need more credits? Purchase packs that never expire:

PackPricePer Credit
50,000 credits €9 / £7.50 / ¥1,500 €0.00018
250,000 credits €29 / £24 / ¥4,800 €0.000116
1,000,000 credits €79 / £66 / ¥13,000 €0.000079