Introduction

RapidDNS supports advanced search capabilities powered by Elasticsearch. You can use the Lucene query syntax to perform complex queries, filter by specific fields, and combine multiple conditions.

Searchable Fields

You can restrict your search to specific fields using the field_name:value syntax. The following fields are available:

Field Name Description Example
domain The main domain name (SLD) without TLD (e.g., "google" for google.com) domain:google
subdomain The full subdomain (e.g., www.google.com) subdomain:api.google.com
type DNS Record Type (A, CNAME, MX, NS, etc.) type:CNAME
value The resolved value (IP address or target domain) value:1.1.1.1
tld Top Level Domain (e.g., com, net, org) tld:org
is_root Boolean indicating if it is a root domain (true/false) is_root:true
resolver The DNS resolver IP that provided the record resolver:8.8.8.8

Query Syntax

Boolean Operators

Combine terms using AND, OR, and NOT (must be uppercase).

  • AND: domain:example AND type:A (Matches both)
  • OR: type:CNAME OR type:A (Matches either)
  • NOT: domain:example NOT type:TXT (Excludes TXT records)
Wildcards

Use * for multiple character wildcards and ? for single character wildcards.

Performance Warning: Fuzzy searches and wildcard queries (especially those starting with *) may be significantly slower and take longer to execute due to the large size of the database (5 billion+ records). Please be patient.

Note: For wildcard searches on the subdomain field, please use subdomain.keyword for best results.

  • subdomain.keyword:*.example.com matches www.example.com, api.example.com, etc.
  • domain:te?t matches test, text, etc. (SLD only)
Grouping

Use parentheses () to group clauses.

  • (type:A OR type:AAAA) AND domain:google

Practical Examples

1. Find all records for google.com:
domain:google AND tld:com
2. Find subdomains matching a pattern:
subdomain.keyword:*.google.com
3. Search for a specific IP address in values:
value:"1.1.1.1"
4. Find CNAME records pointing to AWS:
type:CNAME AND value:*.amazonaws.com
5. Complex filtering:
(domain:apple OR domain:google) AND type:A AND tld:com