# Whoisfreaks

Best Source For Domain WHOIS Database and API.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 17
- **Triggers:** 0
- **Slug:** `WHOISFREAKS`
- **Version:** 20260312_00

## Tools

### ASN WHOIS Lookup

**Slug:** `WHOISFREAKS_ASN_WHOIS_LOOKUP`

Tool to retrieve comprehensive ASN WHOIS information including ownership, network infrastructure, and IP address ranges. Use when you need to identify ASN ownership, organization details, or associated IP blocks for network administration or security analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asn` | string | Yes | The Autonomous System Number. Accepts both with and without 'as' prefix (e.g., 'AS15169', '15169', 'as1009'). |
| `format` | string ("json" | "xml") | No | Response format as either 'json' or 'xml'. Defaults to JSON if unspecified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk DNS Lookup

**Slug:** `WHOISFREAKS_BULK_DNS_LOOKUP`

Tool to process multiple domains or IPs simultaneously, returning all DNS records in a single request (max 100). Use when you need to retrieve DNS records for multiple domains at once for efficient batch processing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | DNS record type: 'all' or comma-separated list of types (A, AAAA, TXT, NS, MX, SOA, SPF, CNAME). For domains, all 8 DNS types are fetched. For IP addresses, only PTR records are retrieved. |
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |
| `domainNames` | array | No | Array of domain names to query (max 100). Required if ipAddresses is not provided. |
| `ipAddresses` | array | No | Array of IP addresses to query for PTR records (max 100). Required if domainNames is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Domain Availability Check

**Slug:** `WHOISFREAKS_BULK_DOMAIN_AVAILABILITY_CHECK`

Tool to check availability of multiple domains in one request (max 100 domains). Use when you need to verify if domain names are available for registration. Response time ranges from 16 seconds to 1 minute for 100 domains.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "xml") | No | Response data format - either json or xml. Defaults to json if not specified. |
| `domainNames` | array | Yes | Array of domain names to check availability. Maximum 100 domains per request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk WHOIS Lookup

**Slug:** `WHOISFREAKS_BULK_WHOIS_LOOKUP`

Tool to query WHOIS information for up to 100 domains in a single request. Use when you need comprehensive registration details, contact information, name servers, and domain status for multiple domains. Response includes normalized and parsed WHOIS data with 1 credit charged per successful query for each domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "xml") | No | Response data format - either json or xml. Defaults to json if not specified. |
| `domainNames` | array | Yes | Array of domain names to query WHOIS information. Maximum 100 domains per request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### DNS Live Lookup

**Slug:** `WHOISFREAKS_DNS_LIVE_LOOKUP`

Tool to perform real-time DNS record resolution for network diagnostics and configuration verification. Use when you need to retrieve current DNS records for a domain or perform reverse DNS lookup for an IP address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | DNS record type: 'all' or comma-separated list of types (A, AAAA, TXT, NS, MX, SOA, SPF, CNAME). |
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |
| `ipAddress` | string | No | The IP address for PTR record lookup. Required if domainName is not provided. |
| `domainName` | string | No | The domain name for DNS lookup. Required if ipAddress is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Domain Availability

**Slug:** `WHOISFREAKS_DOMAIN_AVAILABILITY_CHECK`

Tool to check if a domain is available for registration with optional suggestions. Use when you need to verify domain availability or get alternative domain suggestions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sug` | boolean | No | Enable domain name suggestions if the domain is not available. Defaults to false. |
| `count` | integer | No | Number of domain suggestions to return (1-100). Only applicable when sug=true. Defaults to 5. |
| `domain` | string | Yes | The domain name to check availability for (e.g., 'example.com'). |
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain Files Status

**Slug:** `WHOISFREAKS_GET_DOMAINER_FILES_STATUS`

Tool to check availability and update status of domain data files including newly registered, expired, and dropped domains. Use when you need to verify that domain data files are prepared and ready for download before accessing file download endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IP Geolocation Lookup

**Slug:** `WHOISFREAKS_IP_GEOLOCATION_LOOKUP`

Tool to retrieve geographic location information for an IP address including country, city, coordinates, ISP, and security details. Use when you need to identify the physical location of an IP, detect VPN/proxy usage, or gather network intelligence for security or analytics purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to get geolocation data for (e.g., '8.8.8.8' or '2001:4860:4860::8888'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IP WHOIS Lookup

**Slug:** `WHOISFREAKS_IP_WHOIS_LOOKUP`

Tool to retrieve comprehensive WHOIS information for an IP address including organization, ISP, and network details. Use when you need to identify IP ownership, allocation status, or contact information for network administration or security purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address for WHOIS lookup (e.g., '8.8.8.8' or 'fe80::200:5aee:feaa:20a2'). |
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Security Threat Lookup

**Slug:** `WHOISFREAKS_SECURITY_THREAT_LOOKUP`

Tool to check if an IP address is associated with malicious activity, security threats, or appears on blocklists. Use when you need to assess IP reputation, detect VPN/proxy/Tor usage, identify bots or spam sources, or evaluate security risk for access control and fraud prevention.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to check for security threats, malicious activity, or blocklist presence (e.g., '8.8.8.8' or '2001:4860:4860::8888'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### SSL Certificate Lookup

**Slug:** `WHOISFREAKS_SSL_CERTIFICATE_LOOKUP`

Tool to fetch live SSL certificate with full secure cert chain, validity dates, and issuer information. Use when you need to retrieve SSL certificate details for a domain, including certificate validation dates, issuer details, public key information, and certificate extensions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chain` | boolean | No | Set to true to retrieve the complete certificate chain sorted from end-user to root certificate. Defaults to false. |
| `format` | string ("JSON" | "XML") | No | Response format - either JSON or XML. Defaults to JSON. |
| `sslRaw` | boolean | No | Set to true to obtain the raw OpenSSL response. Defaults to false. |
| `domainName` | string | Yes | The domain name for which SSL certificate data is requested (e.g., 'whoisfreaks.com', 'google.com'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subdomain Lookup

**Slug:** `WHOISFREAKS_SUBDOMAINS_LOOKUP`

Tool to discover all subdomains associated with a domain name. Use when you need to enumerate subdomains for security assessment, asset discovery, or domain reconnaissance. Supports filtering by active/inactive status and date ranges.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. Defaults to 1. |
| `after` | string | No | Fetch subdomain records created after this date (YYYY-MM-DD format). Defaults to oldest record if not specified. |
| `before` | string | No | Fetch subdomain records created before this date (YYYY-MM-DD format). Defaults to current date if not specified. |
| `domain` | string | Yes | The domain name for which to discover subdomains. |
| `format` | string ("json" | "xml") | No | Response format: 'json' or 'xml'. Defaults to JSON if not specified. |
| `status` | string ("active" | "inactive") | No | Filter subdomains by status: 'active' for currently active subdomains, 'inactive' for inactive ones. Omit to retrieve both active and inactive subdomains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHOIS Historical Lookup

**Slug:** `WHOISFREAKS_WHOIS_HISTORICAL_LOOKUP`

Tool to access historical domain records from comprehensive database with up to 100 records per page. Use when you need to retrieve historical WHOIS data for a domain dating back to 1986. Database is updated monthly with one-month data latency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |
| `domainName` | string | Yes | The domain name for which historical WHOIS data is requested (e.g., 'google.com'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHOIS Live Lookup V2

**Slug:** `WHOISFREAKS_WHOIS_LIVE_LOOKUP_V2`

Tool to fetch real-time WHOIS domain data using v2.0 endpoint. Use when you need current domain ownership, registration dates, contact information, or nameserver details via the updated v2.0 API. Note that some fields may show 'REDACTED FOR PRIVACY' due to ICANN privacy regulations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json" | "xml") | No | Response format as either 'json' or 'xml'. Defaults to JSON if unspecified. |
| `domainName` | string | Yes | The domain name requiring WHOIS data retrieval (e.g., 'google.com', 'example.com'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHOIS Reverse Lookup By Company

**Slug:** `WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_COMPANY`

Tool to search for domains registered by a specific company or organization using reverse WHOIS lookup. Use when you need to find all domains associated with a particular company name. Performs full-text phrase matching with pagination support. Charges 5 credits per page retrieved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("default" | "mini") | No | Response mode. 'default' returns up to 50 comprehensive WHOIS records per page. 'mini' returns up to 100 records per page with limited fields (domain name, dates, owner, company, email). Default: 'default'. |
| `page` | integer | No | Page number for pagination. Must be >= 1. Default: 1. |
| `exact` | boolean | No | Set to true to return only exact matches, false for phrase matching. Default: false (phrase matching). |
| `format` | string ("JSON" | "XML") | No | Response format. Default: 'JSON'. |
| `company` | string | Yes | The organization/company name to search for. Uses full-text phrase matching. For example, searching 'united nations' will match 'united nation', 'united nations', 'united nations volunteers'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHOIS Reverse Lookup by Email

**Slug:** `WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_EMAIL`

Tool to search for domains registered with a specific email address. Use when you need to find all domains associated with an email in WHOIS records. Supports exact or regex email matching. Returns paginated results with domain registration details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("default" | "mini") | No | Response detail level. 'mini' returns 100 records/page with limited fields (domain, dates, owner, company, email). 'default' returns 50 records/page with full WHOIS details. Defaults to 'default'. |
| `page` | integer | No | Page number for pagination to get next or desired page of results. Defaults to 1. |
| `email` | string | Yes | The email address to search for in WHOIS records. Supports exact or regex match (e.g., 'support@google.com' or 'g***@outlook.com'). |
| `format` | string ("JSON" | "XML") | No | Response format type. Defaults to JSON. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHOIS Reverse Lookup By Owner

**Slug:** `WHOISFREAKS_WHOIS_REVERSE_LOOKUP_BY_OWNER`

Tool to search for domains registered by a specific owner name using reverse WHOIS lookup. Use when you need to find all domains associated with a particular registrant or owner name. Performs pattern-based full-text search with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("default" | "mini") | No | Response mode. 'default' returns up to 50 records per page with comprehensive fields. 'mini' returns up to 100 records per page with limited fields. Default: 'default'. |
| `page` | integer | No | Page number for pagination control. Must be >= 1. Default: 1. |
| `exact` | boolean | No | Set to true for exact matching, false for pattern matching. Default: false (pattern matching). |
| `owner` | string | Yes | Full-text search on registrant/owner name. Pattern matching is case-insensitive. For example, 'michael' will match within 'Michael Smith'. |
| `format` | string ("JSON" | "XML") | No | Response format. Default: 'JSON'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |