WhoisFreaks

https://whoisfreaks.com/products/
Admin
WhoisFreaks provides powerful APIs and data feeds for domain intelligence, DNS records, IP...
Tokens:133,325
Snippets:1,500
Trust Score:10
Update:3 days ago
Show doc for...
Tokens:
Raw
### Bulk DNS Lookup Implementation Example

Source: https://whoisfreaks.com/products/dns-checker-api/python

A complete example showing how to initialize the WhoisfreaksApi client, perform a bulk lookup, and handle potential ApiError exceptions.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    dns_bulk_info = client.bulk_dns_lookup(type='all', api_key=API_KEY, domain_names=['domain1.com', 'domain2.com'], ip_addresses=['1.1.1.1', '8.8.8.8'])
    dns_bulk_info = {k: v for k, v in dns_bulk_info.dict().items() if v is not None}     # Filtering the Null values

    print(dns_bulk_info)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### IP WHOIS Lookup Example Usage

Source: https://whoisfreaks.com/products/whois-api/python

Complete example showing how to initialize the API client, perform an IP lookup, and handle potential ApiError exceptions.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    ip_info = client.ip_whois_lookup(api_key=API_KEY, ip='1.1.1.1')
    ip_info = {k: v for k, v in ip_info.dict().items() if v is not None}     # Filtering the Null values

    print(ip_info)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### Reverse WHOIS Lookup Example Usage

Source: https://whoisfreaks.com/products/whois-api/python

Complete example showing how to initialize the API client, perform a reverse lookup, and handle potential ApiError exceptions.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    whois_domains_reverse = client.whois_lookup(whois='reverse', api_key=API_KEY, keyword='example')
    whois_domains_reverse = {k: v for k, v in whois_domains_reverse.dict().items() if v is not None}     # Filtering the Null values

    print(whois_domains_reverse)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### cURL GET request for Subdomains API

Source: https://whoisfreaks.com/products/subdomains-api

A command-line example using cURL to fetch subdomain data by passing query parameters directly in the URL.

```bash
curl -X GET \
 "https://api.whoisfreaks.com/v1.0/subdomains?apiKey=YOUR_API_KEY&domain=google.com&after=2010-02-28&before=2026-10-18&status=active&page=3"
```

--------------------------------

### DNS Live Lookup Implementation

Source: https://whoisfreaks.com/products/dns-checker-api/python

This example demonstrates how to initialize the WhoisfreaksApi client and perform a live DNS lookup. It includes error handling for ApiError and filters out null values from the response.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    dns_info = client.live_dns_lookup(type='all', api_key=API_KEY, domain_name='example.com', ip_address='1.1.1.1')
    dns_info = {k: v for k, v in dns_info.dict().items() if v is not None}     # Filtering the Null values

    print(dns_info)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### Make a GET request with cURL

Source: https://whoisfreaks.com/products/domain-availability-api

Use cURL to perform a GET request to the domain availability endpoint with query parameters.

```bash
curl -X GET \
 "https://api.whoisfreaks.com/v2.0/domain/availability?apiKey=YOUR_API_KEY&domain=whoisfreaks.com&sug=true&count=10"
```

--------------------------------

### Bulk Domain Lookup Implementation

Source: https://whoisfreaks.com/products/whois-api/python

A complete example showing how to initialize the WhoisfreaksApi client, perform a bulk lookup, and handle potential ApiError exceptions.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    bulk_whois_response = client.bulk_domain_lookup(api_key=API_KEY, domain_names=['google.es', 'hey.com', 'jfreaks.com', 'ss.ssss'])
    bulk_whois_response = {k: v for k, v in bulk_whois_response.dict().items() if v is not None}     # Filtering the Null values

    print(bulk_whois_response)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### Python GET request using requests library

Source: https://whoisfreaks.com/products/subdomains-api

Uses the requests library to send a GET request with parameters defined in a dictionary.

```python
import requests

resp = requests.get(
 "https://api.whoisfreaks.com/v1.0/subdomains",
 params={
 "apiKey": "YOUR_API_KEY",
 "domain": "google.com",
 "after": "2010-02-28",
 "before": "2026-10-18",
 "status": "active",
 "page": "3",
 },
 timeout=30,
)
data = resp.json()
print(data["domain"], data["status"])
```

--------------------------------

### Retrieve Country Metadata via GET Request

Source: https://whoisfreaks.com/products/ip-geolocation-api

Perform a GET request to the geolocation endpoint to retrieve country-specific metadata for an IP address.

```http
GET/v1.0/geolocation?apiKey=API_KEY&ip=8.8.8.8
```

```json
{
  "country_metadata": {
    "calling_code": "+1",
    "tld": ".us",
    "languages": [
      "en-US",
      "es-US",
      "haw",
      "fr"
    ]
  }
}
```

--------------------------------

### Retrieve Location Data via GET Request

Source: https://whoisfreaks.com/products/ip-geolocation-api

Perform a GET request to the geolocation endpoint to retrieve location-specific details for an IP address.

```http
GET/v1.0/geolocation?apiKey=API_KEY&ip=8.8.8.8
```

```json
{
  "location": {
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code2": "US",
    "country_code3": "USA",
    "country_name": "United States",
    "country_name_official": "United States of America",
    "country_capital": "Washington, D.C.",
    "state_prov": "California",
    "state_code": "US-CA",
    "district": "Santa Clara",
    "city": "Mountain View",
    "locality": "Mountain View",
    "accuracy_radius": "20.842",
    "confidence": "low",
    "zipcode": "94043-1351",
    "latitude": "37.42240",
    "longitude": "-122.08421",
    "is_eu": false,
    "geoname_id": "6301403",
    "country_emoji": "🇺🇸"
  }
}
```

--------------------------------

### Retrieve Network Information via GET Request

Source: https://whoisfreaks.com/products/ip-geolocation-api

Perform a GET request to the geolocation endpoint to retrieve network and ASN details for an IP address.

```http
GET/v1.0/geolocation?apiKey=API_KEY&ip=8.8.8.8
```

```json
{
  "network": {
    "asn": {
      "as_number": "AS15169",
      "organization": "Google LLC",
      "country": "US",
      "asn_name": "GOOGLE",
      "type": "HOSTING",
      "domain": "google.com",
      "date_allocated": "2000-03-30",
      "allocation_status": "",
      "num_of_ipv4_routes": "1070",
      "num_of_ipv6_routes": "153",
      "rir": "ARIN"
    },
    "connection_type": "",
    "company": {
      "name": "Google LLC",
      "type": "HOSTING",
      "domain": "google.com"
    }
  }
}
```

--------------------------------

### Domain Availability Lookup Implementation

Source: https://whoisfreaks.com/products/domain-availability-api/python

A complete example showing how to initialize the WhoisfreaksApi client, perform a lookup, filter null values from the response, and handle potential ApiError exceptions.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    domain_available_response = client.domain_availability_lookup(api_key=API_KEY, domain='google.com', sug=True)
    domain_available_response = {k: v for k, v in domain_available_response.dict().items() if v is not None}     # Filtering the Null values

    print(domain_available_response)
except ApiError as error:
    print(error.status_code, error.body)
```

--------------------------------

### Retrieve Currency Information via GET Request

Source: https://whoisfreaks.com/products/ip-geolocation-api

Perform a GET request to the geolocation endpoint to retrieve currency details associated with the IP address location.

```http
GET/v1.0/geolocation?apiKey=API_KEY&ip=8.8.8.8
```

```json
{
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  }
}
```

--------------------------------

### Implement SSL Live Lookup with Error Handling

Source: https://whoisfreaks.com/products/ssl-certificate-api/python

Demonstrates initializing the WhoisfreaksApi client and performing a live lookup with error handling for ApiError. It also includes a dictionary comprehension to filter out null values from the response.

```python
from whoisfreaks import WhoisfreaksApi
from whoisfreaks.core.api_error import ApiError

API_KEY = os.environ["WHOISFREAKS_API_KEY"]
client = WhoisfreaksApi()

try:
    domain_ssl_info = client.ssl_live_lookup(api_key=API_KEY, domain_name='google.com')
    domain_ssl_info = {k: v for k, v in domain_ssl_info.dict().items() if v is not None}     # Filtering the Null values

    print(domain_ssl_info)
except ApiError as error:
    print(error.status_code, error.body)
```
Tokens:
Raw