Domain Search Examples · Example 2 of 5 in Combinations › Must, Should and Must Not

Should: Either of Two Registrars

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

Field: domain.whois.registrar
Operator: eq
Logic: should

With only should filters, a record matches when at least one of them does: domains registered through either registrar.

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": {
    "should": [
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "godaddy.com, llc"
      },
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "namecheap, inc."
      }
    ]
  }
}'

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": {
        "should": [
            {
                "name": "domain.whois.registrar",
                "type": "eq",
                "value": "godaddy.com, llc"
            },
            {
                "name": "domain.whois.registrar",
                "type": "eq",
                "value": "namecheap, inc."
            }
        ]
    }
}

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: {
      should: [
        {
          name: "domain.whois.registrar",
          type: "eq",
          value: "godaddy.com, llc"
        },
        {
          name: "domain.whois.registrar",
          type: "eq",
          value: "namecheap, inc."
        }
      ]
    }
  }),
});

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

package main

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

func main() {
	payload := strings.NewReader(`{
  "filters": {
    "should": [
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "godaddy.com, llc"
      },
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "namecheap, inc."
      }
    ]
  }
}`)

	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": {
                "should": [
                  {
                    "name": "domain.whois.registrar",
                    "type": "eq",
                    "value": "godaddy.com, llc"
                  },
                  {
                    "name": "domain.whois.registrar",
                    "type": "eq",
                    "value": "namecheap, inc."
                  }
                ]
              }
            }""";

        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": {
        "should": [
          {
            "name": "domain.whois.registrar",
            "type": "eq",
            "value": "godaddy.com, llc"
          },
          {
            "name": "domain.whois.registrar",
            "type": "eq",
            "value": "namecheap, inc."
          }
        ]
      }
    }
    """;

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": {
    "should": [
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "godaddy.com, llc"
      },
      {
        "name": "domain.whois.registrar",
        "type": "eq",
        "value": "namecheap, inc."
      }
    ]
  }
}
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": {
      "should": [
        {
          "name": "domain.whois.registrar",
          "type": "eq",
          "value": "godaddy.com, llc"
        },
        {
          "name": "domain.whois.registrar",
          "type": "eq",
          "value": "namecheap, inc."
        }
      ]
    }
  }
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

Shortened for this page: results: 3 of 25 shown

Response Body

{
  "page": 1,
  "page_size": 25,
  "result_count": 316898776,
  "results": [
    {
      "punycode": "mail.plano-painters.com",
      "unicode": "mail.plano-painters.com",
      "is_idn": false,
      "subdomain": {
        "punycode": "mail",
        "unicode": "mail",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 4
      },
      "subdomain_last": {
        "punycode": "mail",
        "unicode": "mail",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 4
      },
      "subdomain_root": {
        "punycode": "mail",
        "unicode": "mail",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 4
      },
      "name": {
        "punycode": "mail.plano-painters",
        "unicode": "mail.plano-painters",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": true,
        "length": 18,
        "lang": "en",
        "keywords": [
          "mail",
          "plano",
          "painters"
        ],
        "keyword_count": 3,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "plano-painters.com",
        "unicode": "plano-painters.com",
        "is_idn": false,
        "name": {
          "punycode": "plano-painters",
          "unicode": "plano-painters",
          "is_idn": false,
          "contains_letter": true,
          "contains_number": false,
          "contains_hyphen": true,
          "length": 14,
          "lang": "en",
          "keywords": [
            "plano",
            "painters"
          ],
          "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": "2021-06-24T13:40:49Z",
          "update_date": "2026-06-25T08:22:33Z",
          "expiry_date": "2027-06-24T13:40:49Z",
          "registrar": "namecheap, inc.",
          "registrant": {
            "name": "redacted for privacy",
            "organization": "privacy service provided by withheld for privacy ehf",
            "street": "kalkofnsvegur 2",
            "city": "reykjavik",
            "state": "capital region",
            "postal_code": "101",
            "country": "is",
            "phone": "+354.4212434",
            "email": "user@withheldforprivacy.com"
          },
          "name_servers": [
            "dns101.registrar-servers.com",
            "dns102.registrar-servers.com"
          ],
          "domain_status": [
            "clienttransferprohibited"
          ],
          "whois_server": "whois.namecheap.com",
          "check_date": "2026-06-28T02:51:28Z"
        },
        "whois_normalized": {
          "registrant": {
            "organization": "privacyserviceprovidedbywithheldforprivacyehf",
            "phone": "3544212434",
            "email": "user@withheldforprivacy.com",
            "email_fqdn_apex": "withheldforprivacy.com",
            "email_domain_apex": "withheldforprivacy.com"
          }
        },
        "whois_last_check_date": "2026-06-28T02:51:28Z",
        "whois_create_date_historical": null,
        "whois_last_change_date": "2026-06-28T02:51:36Z",
        "whois_registrant_email_historical": null,
        "whois_privacy_enabled": true,
        "dns": null,
        "dns_last_change_date": "2026-08-07T18:32:08Z",
        "ip_history": null,
        "ssl": {
          "validity": {
            "start_date": "2021-10-23T17:29:40Z",
            "end_date": "2022-01-21T17:29:39Z"
          },
          "serial_number": "279365008731785261458691835731540202068472",
          "check_date": "2021-10-27T02:48:22Z"
        },
        "ssl_last_change_date": "2026-08-23T18:57:44Z"
      },
      "type": 2,
      "subdomain_level_count": 1,
      "dns": {
        "a": {
          "update_date": "2026-09-12T10:53:27Z",
          "ip_addresses": [
            "104.21.25.170",
            "172.67.134.104"
          ]
        },
        "aaaa": {
          "update_date": "2026-09-12T10:53:27Z",
          "ip_addresses": [
            "2606:4700:3032::ac43:8668",
            "2606:4700:3036::6815:19aa"
          ]
        },
        "ns": {
          "update_date": "2026-09-12T10:53:27Z",
          "name_servers": []
        },
        "mx": {
          "update_date": "2026-09-12T10:53:27Z",
          "mail_servers": []
        },
        "soa": {
          "update_date": "2026-09-12T10:53:27Z",
          "mnames": [],
          "rnames": [],
          "rname_emails": []
        },
        "txt": {
          "update_date": "2026-09-12T10:53:27Z",
          "values": []
        },
        "cname": {
          "update_date": "2026-09-12T10:53:27Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-12T10:53:29Z",
      "ip_history": [
        "66.248.237.7",
        "170.39.79.214",
        "50.28.7.251",
        "67.227.240.235",
        "172.233.219.31",
        "104.21.25.170",
        "172.67.134.104"
      ],
      "ssl": null,
      "ssl_last_change_date": "2026-03-31T15:41:31Z",
      "webdata": {
        "connection_status": "not_resolved",
        "html": null,
        "http": null
      }
    },
    {
      "punycode": "wangzhan.medicosyr.com",
      "unicode": "wangzhan.medicosyr.com",
      "is_idn": false,
      "subdomain": {
        "punycode": "wangzhan",
        "unicode": "wangzhan",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 8
      },
      "subdomain_last": {
        "punycode": "wangzhan",
        "unicode": "wangzhan",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 8
      },
      "subdomain_root": {
        "punycode": "wangzhan",
        "unicode": "wangzhan",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 8
      },
      "name": {
        "punycode": "wangzhan.medicosyr",
        "unicode": "wangzhan.medicosyr",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 17,
        "lang": "en",
        "keywords": [
          "wang",
          "zhan",
          "medico",
          "syr"
        ],
        "keyword_count": 4,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "medicosyr.com",
        "unicode": "medicosyr.com",
        "is_idn": false,
        "name": {
          "punycode": "medicosyr",
          "unicode": "medicosyr",
          "is_idn": false,
          "contains_letter": true,
          "contains_number": false,
          "contains_hyphen": false,
          "length": 9,
          "lang": "it",
          "keywords": [
            "medico",
            "syr"
          ],
          "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": "2025-08-17T19:37:30Z",
          "update_date": "2026-08-16T17:34:56Z",
          "expiry_date": "2027-08-17T19:37:30Z",
          "registrar": "namecheap, inc.",
          "registrant": {
            "name": "redacted for privacy",
            "organization": "privacy service provided by withheld for privacy ehf",
            "street": "kalkofnsvegur 2",
            "city": "reykjavik",
            "state": "capital region",
            "postal_code": "101",
            "country": "is",
            "phone": "+354.4212434",
            "email": "user@withheldforprivacy.com"
          },
          "name_servers": [
            "dns1.namecheaphosting.com",
            "dns2.namecheaphosting.com"
          ],
          "domain_status": [
            "clienttransferprohibited"
          ],
          "whois_server": "whois.namecheap.com",
          "check_date": "2026-08-18T07:35:20Z"
        },
        "whois_normalized": {
          "registrant": {
            "organization": "privacyserviceprovidedbywithheldforprivacyehf",
            "phone": "3544212434",
            "email": "user@withheldforprivacy.com",
            "email_fqdn_apex": "withheldforprivacy.com",
            "email_domain_apex": "withheldforprivacy.com"
          }
        },
        "whois_last_check_date": "2026-08-18T07:35:20Z",
        "whois_create_date_historical": null,
        "whois_last_change_date": "2026-08-18T07:39:51Z",
        "whois_registrant_email_historical": null,
        "whois_privacy_enabled": true,
        "dns": {
          "a": {
            "update_date": "2026-09-08T16:29:44Z",
            "ip_addresses": [
              "31.56.179.91"
            ]
          }
        },
        "dns_last_change_date": "2026-09-08T16:36:15Z",
        "ip_history": null,
        "ssl": {
          "validity": {
            "start_date": "2026-08-03T03:21:51Z",
            "end_date": "2026-11-01T03:21:50Z"
          },
          "serial_number": "468767781346683444606917953719766290516282",
          "check_date": "2026-08-31T17:43:23Z"
        },
        "ssl_last_change_date": "2026-08-31T17:44:19Z"
      },
      "type": 2,
      "subdomain_level_count": 1,
      "dns": {
        "a": {
          "update_date": "2026-09-12T10:57:33Z",
          "ip_addresses": [
            "31.56.179.91"
          ]
        },
        "aaaa": {
          "update_date": "2026-09-12T10:57:33Z",
          "ip_addresses": []
        },
        "ns": {
          "update_date": "2026-09-12T10:57:33Z",
          "name_servers": []
        },
        "mx": {
          "update_date": "2026-09-12T10:57:33Z",
          "mail_servers": []
        },
        "soa": {
          "update_date": "2026-09-12T10:57:33Z",
          "mnames": [],
          "rnames": [],
          "rname_emails": []
        },
        "txt": {
          "update_date": "2026-09-12T10:57:33Z",
          "values": []
        },
        "cname": {
          "update_date": "2026-09-12T10:57:33Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-12T10:57:33Z",
      "ip_history": [
        "31.56.179.91"
      ],
      "ssl": null,
      "ssl_last_change_date": null,
      "webdata": null
    },
    {
      "punycode": "autoconfig.web.concilioecogintern.org",
      "unicode": "autoconfig.web.concilioecogintern.org",
      "is_idn": false,
      "subdomain": {
        "punycode": "autoconfig.web",
        "unicode": "autoconfig.web",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 13
      },
      "subdomain_last": {
        "punycode": "autoconfig",
        "unicode": "autoconfig",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 10
      },
      "subdomain_root": {
        "punycode": "web",
        "unicode": "web",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 3
      },
      "name": {
        "punycode": "autoconfig.web.concilioecogintern",
        "unicode": "autoconfig.web.concilioecogintern",
        "is_idn": false,
        "contains_letter": true,
        "contains_number": false,
        "contains_hyphen": false,
        "length": 31,
        "lang": "en",
        "keywords": [
          "auto",
          "config",
          "web",
          "concilio",
          "ecog",
          "intern"
        ],
        "keyword_count": 6,
        "latinized": [],
        "contains_confusable": false
      },
      "domain": {
        "punycode": "concilioecogintern.org",
        "unicode": "concilioecogintern.org",
        "is_idn": false,
        "name": {
          "punycode": "concilioecogintern",
          "unicode": "concilioecogintern",
          "is_idn": false,
          "contains_letter": true,
          "contains_number": false,
          "contains_hyphen": false,
          "length": 18,
          "lang": "en",
          "keywords": [
            "concilio",
            "ecog",
            "intern"
          ],
          "keyword_count": 3
        },
        "extension": {
          "punycode": "org",
          "unicode": "org",
          "is_idn": false
        },
        "extension_root": {
          "punycode": "org",
          "unicode": "org",
          "is_idn": false
        },
        "extension_sub": null,
        "extension_type": 1,
        "reserved": null,
        "premium": null,
        "registered": true,
        "whois": {
          "create_date": "2024-01-30T23:17:29Z",
          "update_date": "2026-01-05T06:49:18Z",
          "expiry_date": "2027-01-30T23:17:29Z",
          "registrar": "namecheap, inc.",
          "registrant": {
            "name": null,
            "organization": null,
            "street": null,
            "city": null,
            "state": null,
            "postal_code": null,
            "country": null,
            "phone": null,
            "email": null
          },
          "name_servers": [
            "ns71venom.stableserver.net",
            "ns72venom.stableserver.net"
          ],
          "domain_status": [
            "clienttransferprohibited"
          ],
          "whois_server": "whois.namecheap.com",
          "check_date": "2026-08-04T23:35:14Z"
        },
        "whois_normalized": {
          "registrant": null
        },
        "whois_last_check_date": "2026-08-04T23:35:14Z",
        "whois_create_date_historical": null,
        "whois_last_change_date": "2026-01-16T02:33:32Z",
        "whois_registrant_email_historical": null,
        "whois_privacy_enabled": null,
        "dns": {
          "a": {
            "update_date": "2026-09-05T00:31:34Z",
            "ip_addresses": [
              "192.250.227.113"
            ]
          }
        },
        "dns_last_change_date": "2026-09-05T00:32:29Z",
        "ip_history": null,
        "ssl": {
          "validity": {
            "start_date": "2026-07-03T08:07:35Z",
            "end_date": "2026-10-01T08:07:34Z"
          },
          "serial_number": "472298398685987174724017453086357336674201",
          "check_date": "2026-08-05T05:49:36Z"
        },
        "ssl_last_change_date": "2026-07-28T03:37:38Z"
      },
      "type": 2,
      "subdomain_level_count": 2,
      "dns": {
        "a": {
          "update_date": "2026-09-12T11:05:13Z",
          "ip_addresses": [
            "192.250.227.113"
          ]
        },
        "aaaa": {
          "update_date": "2026-09-12T11:05:13Z",
          "ip_addresses": []
        },
        "ns": {
          "update_date": "2026-09-12T11:05:13Z",
          "name_servers": []
        },
        "mx": {
          "update_date": "2026-09-12T11:05:13Z",
          "mail_servers": []
        },
        "soa": {
          "update_date": "2026-09-12T11:05:13Z",
          "mnames": [],
          "rnames": [],
          "rname_emails": []
        },
        "txt": {
          "update_date": "2026-09-12T11:05:13Z",
          "values": []
        },
        "cname": {
          "update_date": "2026-09-12T11:05:13Z",
          "values": []
        },
        "others": []
      },
      "dns_last_change_date": "2026-09-12T11:05:15Z",
      "ip_history": [
        "192.250.227.113"
      ],
      "ssl": null,
      "ssl_last_change_date": null,
      "webdata": null
    }
  ]
}

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: 99838
x-ratelimit-remaining-minute: 9989
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.should[0].name`body	`domain.whois.registrar`
`filters.should[0].type`body	`eq`
`filters.should[0].value`body	`godaddy.com, llc`
`filters.should[1].name`body	`domain.whois.registrar`
`filters.should[1].type`body	`eq`
`filters.should[1].value`body	`namecheap, inc.`

Reference updated September 26, 2026

Request

Related Examples