# Associated Domain Finder Examples

Worked Associated Domain Finder examples: the domains that share a registrant, name servers, IP address, mail servers or certificate organization with a domain.

Source: https://docs.deepinfo.com/reference/discovery/associated-domain-finder/examples/

Last updated: 2026-09-26

---
`GET https://api.deepinfo.com/v1/discovery/associated-domain-finder` · endpoint: [Associated Domain Finder](/reference/discovery/associated-domain-finder/)

Worked examples for the Associated Domain Finder: the domains that share something with a given domain: its registrant’s e-mail, organization or phone, its name servers, IP address or mail servers, or the organization in its SSL certificate. First the default (every association type), then one example per `association` value, two types together, `strict`, `include_subdomains`, paging and ordering. The domains are public organizations’ domains: `paypal.com`, `wikipedia.org`, `apple.com`, `cloudflare.com` and `cloudflare.co.at`.

Every example is a real request with the response the API returned on September 24, 2026 (Deepinfo DEMO account); totals such as `result_count` change as the dataset is updated.

Responses are trimmed for display: `results` shows the first 3 records (11 on the two Default Associations pages, so that the whole list of the eleven requested types shows; lists inside a record are cut to 2 items and texts to 600 characters there), long lists inside a record the first 10 items and very long texts the first 4,000 characters, while `result_count` stays the full total; each page says what was shortened. Personal data (WHOIS contact names, addresses, phone numbers and personal e-mail addresses) is redacted, and cookie values are masked (`<value>`).

Unless an example shows paging, it asks for `page_size=25`. `page` is 1 to 400 and `page_size` 25 to 100 (the API default is 100).

Each result is a full domain record, the same shape as a Domain Detail response: WHOIS, DNS, SSL certificate and web data.

Every response also names the types it was asked for (`requested_association_parameters`) and the types it actually used (`applied_association_parameters`): not every type is applied to every domain.

## Association Types

`association` takes one type or several, separated by commas; without it, the API asks for all eleven. Each value below was accepted and echoed by the live API on September 24, 2026 (other values are answered with HTTP 400, "Invalid values involved").

| Value | Finds Domains With the Same |
|---|---|
| `whois_registrant_email` | Registrant e-mail address |
| `whois_registrant_email_apex_normalized` | Registrant e-mail domain (`domain.whois_normalized.registrant.email_domain_apex`) |
| `whois_registrant_organization` | Registrant organization, as written |
| `whois_registrant_organization_normalized` | Registrant organization, normalized (`paypalinc` for `paypal inc.`) |
| `whois_registrant_phone` | Registrant phone number, as written |
| `whois_registrant_phone_normalized` | Registrant phone number, normalized |
| `whois_ns` | Name servers in the WHOIS record |
| `dns_a` | IP address (DNS A record) |
| `dns_ns` | Name servers in DNS (NS record) |
| `dns_mx` | Mail servers (DNS MX record) |
| `ssl_subject_organization` | Organization in the SSL certificate’s subject |

## Ordering Values

`ordering` sorts the results by one field, ascending; a leading `-` sorts descending (`-domain.whois.create_date` puts the newest registration first). Each value below was tried on the live API on September 24, 2026, on one of the Discovery endpoints, and sorted the results as described. Without `ordering`, the order is not fixed: the same request can return its records in a different order.

| Value | Sorts By |
|---|---|
| `punycode` | The domain name, in its ASCII (punycode) form |
| `domain.extension.punycode` | The extension (TLD) |
| `dns_last_change_date` | The last change seen in the DNS records |
| `ssl_last_change_date` | The last change seen in the SSL certificate |
| `domain.whois_last_change_date` | The last change seen in the WHOIS record |
| `domain.whois.create_date` | The registration date |
| `domain.whois.expiry_date` | The expiry date |
| `domain.whois.update_date` | The date the registry last updated the WHOIS record |

## Parameters Without an Example

As of September 24, 2026, these parameters have no worked example.

| Parameter | Why |
|---|---|
| `export` | `export=true` returns the whole result set as a file download (JSON or CSV) instead of a page of results; these examples show paged JSON only. |
| `export_format` | Used only with `export=true`: `json` (the default) or `csv`. |
| `export_scope` | Used only with `export=true`: `basic`, `default` or `extended` (how many fields each exported record carries). |

Each example links to its own page with the request and the response.

## Default Associations

| Example | Param | Value |
|---|---|---|
| [Domains Associated With a Domain](/reference/discovery/associated-domain-finder/examples/default/) | `domain` | `paypal.com` |
| [Every Association Must Match (Strict)](/reference/discovery/associated-domain-finder/examples/strict/) | `strict`<br>`domain` | `true`<br>`paypal.com` |

## One Association Type

| Example | Param | Value |
|---|---|---|
| [Same Registrant E-mail](/reference/discovery/associated-domain-finder/examples/whois-registrant-email/) | `association`<br>`domain` | `whois_registrant_email`<br>`cloudflare.co.at` |
| [Same Registrant E-mail Domain](/reference/discovery/associated-domain-finder/examples/whois-registrant-email-apex-normalized/) | `association`<br>`domain` | `whois_registrant_email_apex_normalized`<br>`cloudflare.co.at` |
| [Same Registrant Organization](/reference/discovery/associated-domain-finder/examples/whois-registrant-organization/) | `association`<br>`domain` | `whois_registrant_organization`<br>`paypal.com` |
| [Same Normalized Registrant Organization](/reference/discovery/associated-domain-finder/examples/whois-registrant-organization-normalized/) | `association`<br>`domain` | `whois_registrant_organization_normalized`<br>`paypal.com` |
| [Same Registrant Phone](/reference/discovery/associated-domain-finder/examples/whois-registrant-phone/) | `association`<br>`domain` | `whois_registrant_phone`<br>`cloudflare.co.at` |
| [Same Normalized Registrant Phone](/reference/discovery/associated-domain-finder/examples/whois-registrant-phone-normalized/) | `association`<br>`ordering`<br>`domain` | `whois_registrant_phone_normalized`<br>`punycode`<br>`cloudflare.co.at` |
| [Same Name Servers in WHOIS](/reference/discovery/associated-domain-finder/examples/whois-ns/) | `association`<br>`domain` | `whois_ns`<br>`wikipedia.org` |
| [Same IP Address (DNS A)](/reference/discovery/associated-domain-finder/examples/dns-a/) | `association`<br>`domain` | `dns_a`<br>`apple.com` |
| [Same Name Servers in DNS](/reference/discovery/associated-domain-finder/examples/dns-ns/) | `association`<br>`domain` | `dns_ns`<br>`paypal.com` |
| [Same Mail Servers (DNS MX)](/reference/discovery/associated-domain-finder/examples/dns-mx/) | `association`<br>`domain` | `dns_mx`<br>`cloudflare.com` |
| [Same Organization in the Certificate](/reference/discovery/associated-domain-finder/examples/ssl-subject-organization/) | `association`<br>`domain` | `ssl_subject_organization`<br>`paypal.com` |

## Several Association Types

| Example | Param | Value |
|---|---|---|
| [Two Association Types](/reference/discovery/associated-domain-finder/examples/two-associations/) | `association`<br>`domain` | `dns_ns,dns_mx`<br>`paypal.com` |
| [Two Association Types, Both Must Match](/reference/discovery/associated-domain-finder/examples/two-associations-strict/) | `association`<br>`strict`<br>`domain` | `whois_registrant_organization,ssl_subject_organization`<br>`true`<br>`paypal.com` |

## Options

| Example | Param | Value |
|---|---|---|
| [Including Subdomains](/reference/discovery/associated-domain-finder/examples/include-subdomains/) | `include_subdomains`<br>`ordering`<br>`association`<br>`domain` | `true`<br>`-punycode`<br>`dns_ns`<br>`paypal.com` |

## Paging

| Example | Param | Value |
|---|---|---|
| [Second Page of Results](/reference/discovery/associated-domain-finder/examples/second-page/) | `page`<br>`association`<br>`domain` | `2`<br>`dns_ns`<br>`paypal.com` |
| [Larger Pages (100 Results)](/reference/discovery/associated-domain-finder/examples/page-size-100/) | `page_size`<br>`association`<br>`domain` | `100`<br>`dns_ns`<br>`paypal.com` |

## Ordering

| Example | Param | Value |
|---|---|---|
| [Most Recent WHOIS Change First](/reference/discovery/associated-domain-finder/examples/ordering-whois-last-change-date-desc/) | `ordering`<br>`association`<br>`domain` | `-domain.whois_last_change_date`<br>`dns_ns`<br>`paypal.com` |
