WhoisFreaks Docs

Runnable Examples

Copy-paste, ready-to-run examples for every one of the 94 endpoints in all 10 languages (940 files).

Set the WHOISFREAKS_API_KEY environment variable to your key (from https://billing.whoisfreaks.com) and run. Layout: examples/<language>/<Operation>.<ext>.

Endpoint Operation Example file (per language)
Live WHOIS Lookup whoisLive Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk WHOIS Lookup bulkWhois Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Historical WHOIS records for a domain whoisHistory Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Reverse WHOIS lookup by keyword whoisReverse Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Live DNS Lookup dnsLive Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Historical DNS Lookup dnsHistorical Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Reverse DNS Lookup dnsReverse Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Historical DNS Lookup (v2.2) dnsHistoricalV22 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Historical DNS Lookup (v2.3) dnsHistoricalV23 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Reverse DNS Lookup (v2.2) dnsReverseV22 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Reverse DNS Lookup (v2.3) dnsReverseV23 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk DNS Lookup dnsBulk Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Domain Availability Check with Suggestions domainAvailabilityV2 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk Domain Availability Check bulkDomainAvailabilityV2 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Typosquatting Lookup typosquatting Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
SSL Certificate Lookup sslLookup Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP Geolocation Lookup geolocation Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk IP Geolocation bulkGeolocation Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Subdomains Lookup subdomains Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP Reputation Lookup ipReputation Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk IP Reputation bulkIpReputation Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP Reputation Lookup (v2.0) ipReputationV2 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Bulk IP Reputation (v2.0) bulkIpReputationV2 Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Domain Reputation Lookup domainReputation Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
ASN WHOIS Lookup asnWhois Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP WHOIS Lookup ipWhois Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Rotate API Key rotateApiKey Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Account Usage accountUsage Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Database File Status (Public) databaseFileStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered gTLD (CSV) dbNewlyGtld Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered ccTLD (CSV) dbNewlyCctld Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered gTLD Cleaned WHOIS (CSV) dbNewlyGtldCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered ccTLD Cleaned WHOIS (CSV) dbNewlyCctldCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered gTLD (JSON) dbNewlyGtldJson Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered ccTLD (JSON) dbNewlyCctldJson Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Newly Registered With DNS dbNewlyDns Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Expiring Domains dbExpired Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Expiring Cleaned WHOIS dbExpiredCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Dropped Domains dbDropped Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Dropped Domains (JSON) dbDroppedJson Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Dropped With Backlinks dbDroppedBacklinks Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
WHOIS Database Daily dbWhoisDaily Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
WHOIS Database Weekly dbWhoisWeekly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
WHOIS Database Monthly dbWhoisMonthly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
DNS Database Daily dbDnsDaily Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
DNS Database Weekly dbDnsWeekly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
DNS Database Monthly dbDnsMonthly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Subdomains Daily dbSubdomainsDaily Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Subdomains Weekly dbSubdomainsWeekly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Subdomains Monthly dbSubdomainsMonthly Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP to Country Snapshot Status dbIpCountryStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP to Country Snapshot dbIpCountry Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP to City Snapshot Status dbIpCityStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP to City Snapshot dbIpCity Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
ASN WHOIS Snapshot dbAsnWhois Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
ASN WHOIS Snapshot Status dbAsnWhoisStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP WHOIS Snapshot dbIpWhois Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP WHOIS Snapshot Status dbIpWhoisStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP Security Snapshot dbIpSecurity Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
IP Security Snapshot Status dbIpSecurityStatus Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download the daily phishing threat feed (CSV) downloadThreatFeedPhishing Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download a sample of the phishing threat feed (CSV) downloadThreatFeedPhishingSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download the daily malware threat feed (CSV) downloadThreatFeedMalware Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download a sample of the malware threat feed (CSV) downloadThreatFeedMalwareSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download the daily spam threat feed (CSV) downloadThreatFeedSpam Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Download a sample of the spam threat feed (CSV) downloadThreatFeedSpamSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream the daily phishing threat feed (CSV) streamThreatFeedPhishing Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of the phishing threat feed (CSV) streamThreatFeedPhishingSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream the daily malware threat feed (CSV) streamThreatFeedMalware Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of the malware threat feed (CSV) streamThreatFeedMalwareSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream the daily spam threat feed (CSV) streamThreatFeedSpam Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of the spam threat feed (CSV) streamThreatFeedSpamSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream newly registered gTLD domains (CSV) streamDomainerGtld Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered gTLD domains (CSV) streamDomainerGtldCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered gTLD domains with an email (CSV) streamDomainerGtldCleanedEmail Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered gTLD domains with a phone (CSV) streamDomainerGtldCleanedPhone Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream newly registered ccTLD domains (CSV) streamDomainerCctld Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered ccTLD domains (CSV) streamDomainerCctldCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered ccTLD domains with an email (CSV) streamDomainerCctldCleanedEmail Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned newly registered ccTLD domains with a phone (CSV) streamDomainerCctldCleanedPhone Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream expiring domains (CSV) streamDomainerExpired Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned expiring domains (CSV) streamDomainerExpiredCleaned Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned expiring domains with an email (CSV) streamDomainerExpiredCleanedEmail Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream cleaned expiring domains with a phone (CSV) streamDomainerExpiredCleanedPhone Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream dropped domains (CSV) streamDomainerDropped Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream dropped domains with backlinks (CSV) streamDomainerDroppedBacklinks Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of newly registered gTLD domains (CSV) streamDomainerGtldSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of cleaned newly registered gTLD domains (CSV) streamDomainerGtldCleanedSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of newly registered ccTLD domains (CSV) streamDomainerCctldSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of cleaned newly registered ccTLD domains (CSV) streamDomainerCctldCleanedSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of expiring domains (CSV) streamDomainerExpiredSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of cleaned expiring domains (CSV) streamDomainerExpiredCleanedSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of dropped domains (CSV) streamDomainerDroppedSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP
Stream a sample of dropped domains with backlinks (CSV) streamDomainerDroppedBacklinksSample Python · JavaScript · TypeScript · Java · Kotlin · C# / .NET · Ruby · Go · Swift · PHP