> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# whoisfreaks

> WhoisFreaks API

**Server path:** `/whoisfreaks` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                    | Description               |
| ----------------------------------------------------------------------- | ------------------------- |
| [`whoisfreaks_asn_whois_lookup`](#whoisfreaks_asn_whois_lookup)         | ASN WHOIS Lookup          |
| [`whoisfreaks_dns_history`](#whoisfreaks_dns_history)                   | DNS History Lookup        |
| [`whoisfreaks_dns_lookup`](#whoisfreaks_dns_lookup)                     | Live DNS Lookup           |
| [`whoisfreaks_domain_availability`](#whoisfreaks_domain_availability)   | Domain Availability Check |
| [`whoisfreaks_domain_discovery`](#whoisfreaks_domain_discovery)         | Domain Discovery          |
| [`whoisfreaks_ip_geolocation`](#whoisfreaks_ip_geolocation)             | IP Geolocation            |
| [`whoisfreaks_ip_security`](#whoisfreaks_ip_security)                   | IP Security Check         |
| [`whoisfreaks_ip_whois_lookup`](#whoisfreaks_ip_whois_lookup)           | IP WHOIS Lookup           |
| [`whoisfreaks_live_whois_lookup`](#whoisfreaks_live_whois_lookup)       | Live WHOIS Lookup         |
| [`whoisfreaks_reverse_dns_lookup`](#whoisfreaks_reverse_dns_lookup)     | Reverse DNS Lookup        |
| [`whoisfreaks_reverse_whois_lookup`](#whoisfreaks_reverse_whois_lookup) | Reverse WHOIS Lookup      |
| [`whoisfreaks_ssl_lookup`](#whoisfreaks_ssl_lookup)                     | SSL Certificate Lookup    |
| [`whoisfreaks_subdomain_lookup`](#whoisfreaks_subdomain_lookup)         | Subdomain Lookup          |
| [`whoisfreaks_whois_history`](#whoisfreaks_whois_history)               | WHOIS History Lookup      |

***

## whoisfreaks\_asn\_whois\_lookup

ASN WHOIS Lookup

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                              |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------------ |
| `asn`     | string | Yes      | —       | Autonomous System Number to look up. Accepts 'AS15169' or plain '15169'. |
| `format`  | string | No       | —       | Response format. Defaults to JSON.                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "asn": {
        "type": "string",
        "description": "Autonomous System Number to look up. Accepts 'AS15169' or plain '15169'."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "asn"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_dns\_history

DNS History Lookup

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                          |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `domainName` | string  | Yes      | —       | The domain name to retrieve DNS history for.                                         |
| `type`       | string  | No       | —       | DNS record type: A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or 'all'. Defaults to 'all'. |
| `page`       | integer | No       | —       | Page number for paginated results.                                                   |
| `format`     | string  | No       | —       | Response format. Defaults to JSON.                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domainName": {
        "type": "string",
        "description": "The domain name to retrieve DNS history for."
      },
      "type": {
        "type": "string",
        "description": "DNS record type: A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or 'all'. Defaults to 'all'."
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domainName"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_dns\_lookup

Live DNS Lookup

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                          |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------ |
| `domainName` | string | Yes      | —       | The domain name to query for DNS records.                                            |
| `type`       | string | No       | —       | DNS record type: A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or 'all'. Defaults to 'all'. |
| `format`     | string | No       | —       | Response format. Defaults to JSON.                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domainName": {
        "type": "string",
        "description": "The domain name to query for DNS records."
      },
      "type": {
        "type": "string",
        "description": "DNS record type: A, AAAA, MX, NS, CNAME, SOA, TXT, SPF, or 'all'. Defaults to 'all'."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domainName"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_domain\_availability

Domain Availability Check

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                          |
| --------- | ------- | -------- | ------- | -------------------------------------------------------------------- |
| `domain`  | string  | Yes      | —       | Domain name to check availability for (e.g. whoisfreaks.com).        |
| `sug`     | boolean | No       | —       | If true, return alternative domain suggestions.                      |
| `count`   | integer | No       | —       | Number of suggestions to return (1-100). Only used when sug is true. |
| `format`  | string  | No       | —       | Response format. Defaults to JSON.                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domain": {
        "type": "string",
        "description": "Domain name to check availability for (e.g. whoisfreaks.com)."
      },
      "sug": {
        "type": "boolean",
        "description": "If true, return alternative domain suggestions."
      },
      "count": {
        "type": "integer",
        "description": "Number of suggestions to return (1-100). Only used when sug is true."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domain"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_domain\_discovery

Domain Discovery

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                  |
| -------------- | ------- | -------- | ------- | -------------------------------------------- |
| `keyword`      | string  | No       | —       | Exact string to find in domain labels.       |
| `pattern`      | string  | No       | —       | Wildcard pattern using '\*' (e.g. *google*). |
| `label_length` | integer | No       | —       | Maximum domain label length (excluding TLD). |
| `page`         | integer | No       | —       | Page number for paginated results.           |
| `format`       | string  | No       | —       | Response format. Defaults to JSON.           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "keyword": {
        "type": "string",
        "description": "Exact string to find in domain labels."
      },
      "pattern": {
        "type": "string",
        "description": "Wildcard pattern using '*' (e.g. *google*)."
      },
      "label_length": {
        "type": "integer",
        "description": "Maximum domain label length (excluding TLD)."
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_ip\_geolocation

IP Geolocation

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                               |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------------- |
| `ip`      | string | Yes      | —       | IPv4 or IPv6 address to geolocate (e.g. 8.8.8.8 or 2606:4700:4700::1111). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ip": {
        "type": "string",
        "description": "IPv4 or IPv6 address to geolocate (e.g. 8.8.8.8 or 2606:4700:4700::1111)."
      }
    },
    "required": [
      "PCID",
      "ip"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_ip\_security

IP Security Check

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                       |
| --------- | ------ | -------- | ------- | --------------------------------------------------------------------------------- |
| `ip`      | string | Yes      | —       | IPv4 or IPv6 address to run security analysis on (e.g. 1.1.1.1 or 185.220.101.0). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ip": {
        "type": "string",
        "description": "IPv4 or IPv6 address to run security analysis on (e.g. 1.1.1.1 or 185.220.101.0)."
      }
    },
    "required": [
      "PCID",
      "ip"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_ip\_whois\_lookup

IP WHOIS Lookup

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                             |
| --------- | ------ | -------- | ------- | ----------------------------------------------------------------------- |
| `ip`      | string | Yes      | —       | IPv4 or IPv6 address to look up (e.g. 8.8.8.8 or 2001:4860:4860::8888). |
| `format`  | string | No       | —       | Response format. Defaults to JSON.                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ip": {
        "type": "string",
        "description": "IPv4 or IPv6 address to look up (e.g. 8.8.8.8 or 2001:4860:4860::8888)."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "ip"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_live\_whois\_lookup

Live WHOIS Lookup

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                    |
| ------------ | ------ | -------- | ------- | ---------------------------------------------- |
| `domainName` | string | Yes      | —       | The domain name to look up (e.g. example.com). |
| `format`     | string | No       | —       | Response format. Defaults to JSON.             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domainName": {
        "type": "string",
        "description": "The domain name to look up (e.g. example.com)."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domainName"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_reverse\_dns\_lookup

Reverse DNS Lookup

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                            |
| --------- | ------- | -------- | ------- | ---------------------------------------------------------------------- |
| `value`   | string  | Yes      | —       | The value to search for (IP address, hostname, or wildcard pattern).   |
| `type`    | string  | No       | —       | DNS record type: A, AAAA, MX, NS, CNAME, SOA, or TXT. Defaults to 'A'. |
| `exact`   | boolean | No       | —       | If true, exact match. If false, wildcard matching.                     |
| `page`    | integer | No       | —       | Page number for paginated results.                                     |
| `format`  | string  | No       | —       | Response format. Defaults to JSON.                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "value": {
        "type": "string",
        "description": "The value to search for (IP address, hostname, or wildcard pattern)."
      },
      "type": {
        "type": "string",
        "description": "DNS record type: A, AAAA, MX, NS, CNAME, SOA, or TXT. Defaults to 'A'."
      },
      "exact": {
        "type": "boolean",
        "description": "If true, exact match. If false, wildcard matching."
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "value"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_reverse\_whois\_lookup

Reverse WHOIS Lookup

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                                      |
| --------- | ------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `keyword` | string  | No       | —       | Search term found anywhere in WHOIS records.                                     |
| `email`   | string  | No       | —       | Registrant email address to search for.                                          |
| `owner`   | string  | No       | —       | Registrant or owner name to match.                                               |
| `company` | string  | No       | —       | Organization or company name to match.                                           |
| `mode`    | string  | No       | —       | Detail level: 'mini' returns domains only, 'default' returns full WHOIS records. |
| `exact`   | boolean | No       | —       | If true, enforces exact matching. If false, allows partial matches.              |
| `page`    | integer | No       | —       | Page number for paginated results.                                               |
| `format`  | string  | No       | —       | Response format. Defaults to JSON.                                               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "keyword": {
        "type": "string",
        "description": "Search term found anywhere in WHOIS records."
      },
      "email": {
        "type": "string",
        "description": "Registrant email address to search for."
      },
      "owner": {
        "type": "string",
        "description": "Registrant or owner name to match."
      },
      "company": {
        "type": "string",
        "description": "Organization or company name to match."
      },
      "mode": {
        "type": "string",
        "description": "Detail level: 'mini' returns domains only, 'default' returns full WHOIS records.",
        "enum": [
          "mini",
          "default"
        ]
      },
      "exact": {
        "type": "boolean",
        "description": "If true, enforces exact matching. If false, allows partial matches."
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_ssl\_lookup

SSL Certificate Lookup

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                          |
| ------------ | ------- | -------- | ------- | -------------------------------------------------------------------- |
| `domainName` | string  | Yes      | —       | Domain name to retrieve SSL certificate for (e.g. example.com).      |
| `chain`      | boolean | No       | —       | If true, return the full certificate chain from end-user to root CA. |
| `sslRaw`     | boolean | No       | —       | If true, include the raw OpenSSL response.                           |
| `format`     | string  | No       | —       | Response format. Defaults to JSON.                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domainName": {
        "type": "string",
        "description": "Domain name to retrieve SSL certificate for (e.g. example.com)."
      },
      "chain": {
        "type": "boolean",
        "description": "If true, return the full certificate chain from end-user to root CA."
      },
      "sslRaw": {
        "type": "boolean",
        "description": "If true, include the raw OpenSSL response."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domainName"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_subdomain\_lookup

Subdomain Lookup

**Parameters:**

| Parameter | Type    | Required | Default | Description                                                 |
| --------- | ------- | -------- | ------- | ----------------------------------------------------------- |
| `domain`  | string  | Yes      | —       | Root domain to enumerate subdomains for (e.g. example.com). |
| `status`  | string  | No       | —       | Filter by subdomain status: 'active' or 'inactive'.         |
| `after`   | string  | No       | —       | Return subdomains discovered after this date (YYYY-MM-DD).  |
| `before`  | string  | No       | —       | Return subdomains discovered before this date (YYYY-MM-DD). |
| `page`    | integer | No       | —       | Page number for paginated results.                          |
| `format`  | string  | No       | —       | Response format. Defaults to JSON.                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domain": {
        "type": "string",
        "description": "Root domain to enumerate subdomains for (e.g. example.com)."
      },
      "status": {
        "type": "string",
        "description": "Filter by subdomain status: 'active' or 'inactive'.",
        "enum": [
          "active",
          "inactive"
        ]
      },
      "after": {
        "type": "string",
        "description": "Return subdomains discovered after this date (YYYY-MM-DD)."
      },
      "before": {
        "type": "string",
        "description": "Return subdomains discovered before this date (YYYY-MM-DD)."
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domain"
    ]
  }
  ```
</Expandable>

***

## whoisfreaks\_whois\_history

WHOIS History Lookup

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                     |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------- |
| `domainName` | string | Yes      | —       | The domain name to retrieve history for (e.g. whoisfreaks.com). |
| `format`     | string | No       | —       | Response format. Defaults to JSON.                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domainName": {
        "type": "string",
        "description": "The domain name to retrieve history for (e.g. whoisfreaks.com)."
      },
      "format": {
        "type": "string",
        "description": "Response format. Defaults to JSON.",
        "enum": [
          "json",
          "xml"
        ]
      }
    },
    "required": [
      "PCID",
      "domainName"
    ]
  }
  ```
</Expandable>