Domain Search Examples · Example 1 of 20 in Filters › Name & Extension

Look Up an Exact FQDN

POSThttps://api.deepinfo.com/v1/discovery/domain-search

Field: fqdn
Operator: eq

Matches records whose fqdn equals www.deepinfo.com.

The FQDN is the full host name, in its ASCII (punycode) form.

In the response, look at results[].punycode.

Request

curl

curl -X POST 'https://api.deepinfo.com/v1/discovery/domain-search?page_size=25' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "must": [
      {
        "name": "fqdn",
        "type": "eq",
        "value": "www.deepinfo.com"
      }
    ]
  }
}'

Python

import requests

url = "https://api.deepinfo.com/v1/discovery/domain-search"

params = {
    "page_size": "25"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = {
    "filters": {
        "must": [
            {
                "name": "fqdn",
                "type": "eq",
                "value": "www.deepinfo.com"
            }
        ]
    }
}

response = requests.post(url, params=params, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/discovery/domain-search?page_size=25";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    filters: {
      must: [
        {
          name: "fqdn",
          type: "eq",
          value: "www.deepinfo.com"
        }
      ]
    }
  }),
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	payload := strings.NewReader(`{
  "filters": {
    "must": [
      {
        "name": "fqdn",
        "type": "eq",
        "value": "www.deepinfo.com"
      }
    ]
  }
}`)

	req, err := http.NewRequest("POST", "https://api.deepinfo.com/v1/discovery/domain-search?page_size=25", payload)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String body = """
            {
              "filters": {
                "must": [
                  {
                    "name": "fqdn",
                    "type": "eq",
                    "value": "www.deepinfo.com"
                  }
                ]
              }
            }""";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/discovery/domain-search?page_size=25"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;
using System.Text;

using var client = new HttpClient();

var body = """
    {
      "filters": {
        "must": [
          {
            "name": "fqdn",
            "type": "eq",
            "value": "www.deepinfo.com"
          }
        ]
      }
    }
    """;

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.deepinfo.com/v1/discovery/domain-search?page_size=25");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");
request.Content = new StringContent(body, Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$body = <<<'JSON'
{
  "filters": {
    "must": [
      {
        "name": "fqdn",
        "type": "eq",
        "value": "www.deepinfo.com"
      }
    ]
  }
}
JSON;

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/discovery/domain-search?page_size=25',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/discovery/domain-search?page_size=25')

request = Net::HTTP::Post.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = <<~'JSON'.chomp
  {
    "filters": {
      "must": [
        {
          "name": "fqdn",
          "type": "eq",
          "value": "www.deepinfo.com"
        }
      ]
    }
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

200 OK · application/json

Response Body

{
  "page": 1,
  "page_size": 25,
  "result_count": 1,
  "results": [
    {
      "punycode": "www.deepinfo.com",
      "unicode": "www.deepinfo.com",
      "is_idn": false,
      "subdomain": {
        "punycode": "www",
        "unicode": "www",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 3
      },
      "subdomain_last": {
        "punycode": "www",
        "unicode": "www",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 3
      },
      "subdomain_root": {
        "punycode": "www",
        "unicode": "www",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 3
      },
      "name": {
        "punycode": "www.deepinfo",
        "unicode": "www.deepinfo",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 11,
        "lang": "en",
        "keywords": [
          "www",
          "deep",
          "info"
        ],
        "keyword_count": 3,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "deepinfo.com",
        "unicode": "deepinfo.com",
        "is_idn": false,
        "name": {
          "punycode": "deepinfo",
          "unicode": "deepinfo",
          "is_idn": false,
          "contains_letter": true,
          "contains_number": false,
          "contains_hyphen": false,
          "length": 8,
          "lang": "en",
          "keywords": [
            "deep",
            "info"
          ],
          "keyword_count": 2
        },
        "extension": {
          "punycode": "com",
          "unicode": "com",
          "is_idn": false
        },
        "extension_root": {
          "punycode": "com",
          "unicode": "com",
          "is_idn": false
        },
        "extension_sub": null,
        "extension_type": 1,
        "reserved": null,
        "premium": null,
        "registered": true,
        "whois": {
          "create_date": "2001-06-05T02:57:08Z",
          "update_date": "2025-08-19T07:33:45Z",
          "expiry_date": "2028-10-20T11:59:59Z",
          "registrar": "godaddy online services cayman islands ltd.",
          "registrant": {
            "name": null,
            "organization": null,
            "street": null,
            "city": null,
            "state": null,
            "postal_code": null,
            "country": null,
            "phone": null,
            "email": null
          },
          "name_servers": [
            "may.ns.cloudflare.com",
            "simon.ns.cloudflare.com"
          ],
          "domain_status": [
            "clientdeleteprohibited",
            "clientrenewprohibited",
            "clienttransferprohibited",
            "clientupdateprohibited"
          ],
          "whois_server": "whois.uniregistrar.com",
          "check_date": "2026-08-10T21:24:49Z"
        },
        "whois_normalized": {
          "registrant": null
        },
        "whois_last_check_date": "2026-08-10T21:24:49Z",
        "whois_create_date_historical": null,
        "whois_last_change_date": "2026-08-10T21:01:51Z",
        "whois_registrant_email_historical": null,
        "whois_privacy_enabled": null,
        "dns": {
          "a": {
            "update_date": "2026-08-09T03:36:51Z",
            "ip_addresses": [
              "104.26.10.21",
              "104.26.11.21",
              "172.67.70.198"
            ]
          }
        },
        "dns_last_change_date": "2026-07-21T18:18:11Z",
        "ip_history": null,
        "ssl": {
          "validity": {
            "start_date": "2026-06-03T16:27:33Z",
            "end_date": "2026-09-01T17:27:27Z"
          },
          "serial_number": "61855234530828088905432121166750302202",
          "check_date": "2026-08-10T22:12:37Z"
        },
        "ssl_last_change_date": "2026-08-07T12:22:59Z"
      },
      "type": 2,
      "subdomain_level_count": 1,
      "dns": {
        "a": {
          "update_date": "2026-07-21T22:18:13Z",
          "ip_addresses": [
            "104.26.10.21",
            "104.26.11.21",
            "172.67.70.198"
          ]
        },
        "aaaa": {
          "update_date": "2026-07-21T22:18:13Z",
          "ip_addresses": [
            "2606:4700:20::681a:a15",
            "2606:4700:20::681a:b15",
            "2606:4700:20::ac43:46c6"
          ]
        },
        "ns": {
          "update_date": "2026-07-21T22:18:13Z",
          "name_servers": []
        },
        "mx": {
          "update_date": "2026-07-21T22:18:13Z",
          "mail_servers": []
        },
        "soa": {
          "update_date": "2026-07-21T22:18:13Z",
          "mnames": [],
          "rnames": [],
          "rname_emails": []
        },
        "txt": {
          "update_date": "2026-07-21T22:18:13Z",
          "values": []
        },
        "cname": {
          "update_date": "2026-07-21T22:18:13Z",
          "values": []
        },
        "others": [
          {
            "update_date": "2024-07-02T08:04:53Z",
            "values": [],
            "type": "DNSKEY"
          },
          {
            "update_date": "2024-07-02T08:04:53Z",
            "values": [],
            "type": "DS"
          },
          {
            "update_date": "2024-07-02T08:04:53Z",
            "values": [],
            "type": "SPF"
          },
          {
            "update_date": "2024-07-02T08:04:53Z",
            "values": [
              "\"RFC8482\" \"\""
            ],
            "type": "HINFO"
          }
        ]
      },
      "dns_last_change_date": "2024-06-14T08:09:28Z",
      "ip_history": [
        "104.21.29.10",
        "172.67.171.60",
        "104.26.10.21",
        "104.26.11.21",
        "172.67.70.198"
      ],
      "ssl": {
        "tags": [
          "dla"
        ],
        "fqdns": [
          "www.deepinfo.com"
        ],
        "version": 3,
        "serial_number": "189849484378123535728845751731277906435",
        "fingerprint": {
          "sha256": "9ee43ae2be46ddb49482c3ad47bceb2907175707b94aa1afb5978c91dcfb362a",
          "sha1": "f8f7a3b09df16fc23e3d9b34e062929c05d0dbf1",
          "md5": "88e2268e11595eced4f4291927572e72"
        },
        "validity": {
          "start_date": "2026-07-14T00:48:57Z",
          "end_date": "2026-10-12T01:48:52Z",
          "length": 7779595
        },
        "signature": {
          "is_self_signed": false,
          "is_valid": true,
          "value": "MEYCIQD+W/KyGw9ofgJOFy4/GMRG08/vlioVUr9ugAPEY6wK1AIhAIoo4AdZvUQgtg6ctg5l9ysj3WpEFPj68AFxG/+++Gky",
          "algorithm": {
            "oid": "1.2.840.10045.4.3.2",
            "name": "sha256"
          }
        },
        "issuer_dn": "CN=WE1,O=Google Trust Services,C=US",
        "issuer": {
          "common_name": "WE1",
          "country": "US",
          "state": null,
          "locality": null,
          "organization": "Google Trust Services",
          "organizational_unit": null
        },
        "subject_dn": "CN=www.deepinfo.com",
        "subject": {
          "common_name": "www.deepinfo.com",
          "country": null,
          "state": null,
          "locality": null,
          "organization": null,
          "organizational_unit": null
        },
        "extensions": {
          "authority_key_id": "kHeSNWfE/6jMqeZ72YB5e8yT+Tg=",
          "basic_constraints": {
            "is_ca": false
          },
          "certificate_policies": [
            "2.23.140.1.2.1"
          ],
          "extended_key_usage": {
            "client_auth": null,
            "server_auth": true
          },
          "key_usage": {
            "digital_signature": true,
            "content_commitment": false,
            "key_agreement": false,
            "data_encipherment": false,
            "key_encipherment": false,
            "key_cert_sign": false,
            "crl_sign": false
          },
          "signed_certificate_timestamps": [
            "2026-07-14T01:48:57Z"
          ],
          "subject_alt_name": {
            "dns_names": [
              "www.deepinfo.com"
            ]
          },
          "subject_key_id": "QtbFfIWsoUNLqOrTfWPHJn4pHH0="
        },
        "check_date": "2026-08-10T18:02:40Z"
      },
      "ssl_last_change_date": "2026-08-10T18:02:52Z",
      "webdata": {
        "connection_status": "success",
        "html": {
          "source_code_hash": "2af0b9caeed738a92675819833dc9d1d99fc03ac1bf94dc69ae15210e7a8a8ed"
        },
        "http": {
          "status_code_first": 301,
          "status_code_last": 200,
          "redirection_history": [
            {
              "url": "http://www.deepinfo.com/",
              "status_code": 301
            },
            {
              "url": "https://www.deepinfo.com/",
              "status_code": 200
            }
          ],
          "external_redirection": false,
          "final_url": "https://www.deepinfo.com/",
          "final_fqdn": "www.deepinfo.com",
          "final_domain": "deepinfo.com",
          "headers": {
            "others": [
              {
                "name": "date",
                "value": "Mon, 22 Jun 2026 04:06:01 GMT"
              },
              {
                "name": "transfer_encoding",
                "value": "chunked"
              },
              {
                "name": "connection",
                "value": "keep-alive"
              },
              {
                "name": "report_to",
                "value": "{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=KNfCe7w56euwq6cXGZSz%2FK5et%2FvusCFASFuBeIiy4YDrIHS75WXOphOPVQ0TgYQgBUZFFW8Mddqffc71m649HUqN9w3%2Bz8R8X%2FOUM1DGrjDFhEBoY5qe53L%2BKbXf%2BVRNhoPf\"}]}"
              },
              {
                "name": "nel",
                "value": "{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"
              },
              {
                "name": "link",
                "value": "<https://fonts.googleapis.com>; rel=\"preconnect\""
              },
              {
                "name": "permissions_policy",
                "value": "camera=(), microphone=(), geolocation=(), payment=(), interest-cohort=()"
              },
              {
                "name": "vary",
                "value": "accept-encoding"
              },
              {
                "name": "cf_cache_status",
                "value": "DYNAMIC"
              },
              {
                "name": "cf_ray",
                "value": "a0f860c0ad9a80ba-ORD"
              }
            ],
            "access_control_allow_headers": null,
            "access_control_allow_methods": null,
            "access_control_allow_origin": "*",
            "cache_control": "public, max-age=0, must-revalidate",
            "clear_site_data": null,
            "content_encoding": "gzip",
            "content_security_policy": "default-src 'self'; script-src 'self' https://cdn.jsdelivr.net https://static.cloudflareinsights.com https://widget.intercom.io https://*.intercomcdn.com 'unsafe-inline'; style-src 'self' https://fonts.googleapis.com https://*.intercomcdn.com 'unsafe-inline'; font-src 'self' https://fonts.gstatic.com https://*.intercomcdn.com; img-src 'self' data: https:; connect-src 'self' https://static.cloudflareinsights.com https://*.intercom.io wss://*.intercom.io https://*.intercomcdn.com; frame-ancestors 'none'",
            "content_type": "text/html; charset=utf-8",
            "cross_origin_embedder_policy": null,
            "cross_origin_opener_policy": null,
            "cross_origin_resource_policy": null,
            "expect_ct": null,
            "feature_policy": null,
            "last_modified": null,
            "permission_policy": null,
            "referrer_policy": "strict-origin-when-cross-origin",
            "server": "cloudflare",
            "set_cookie": null,
            "strict_transport_security": "max-age=31536000; includeSubDomains; preload",
            "x_content_type_options": "nosniff",
            "x_download_options": null,
            "x_frame_options": "DENY",
            "x_permitted_cross_domain_policies": null,
            "x_powered_by": null,
            "x_xss_protection": null
          },
          "cookies": []
        }
      }
    }
  ]
}

Content-Type: application/json
ratelimit-limit: 1000
ratelimit-remaining: 999
ratelimit-reset: 1
x-ratelimit-limit-hour: 100000
x-ratelimit-limit-minute: 10000
x-ratelimit-limit-second: 1000
x-ratelimit-remaining-hour: 99999
x-ratelimit-remaining-minute: 9999
x-ratelimit-remaining-second: 999
deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a

Request

What this example sends. Every parameter is documented on Domain Search; the exact request is in the code panel.

Parameter	Value
`page_size`query	`25`
`filters.must[0].name`body	`fqdn`
`filters.must[0].type`body	`eq`
`filters.must[0].value`body	`www.deepinfo.com`

Reference updated September 26, 2026

Request

Related Examples