API Documentation

Usage and endpoints for RapidDNS API

Overview

RapidDNS API supports two modes: Keyword Search and Advanced Query. Requests use GET and return JSON with record details. Authentication via Bearer tokens; higher memberships unlock larger limits.

Authentication & API Key

To access the API, you need a valid API Key. This key is available to Pro and Max users.

  1. Go to your User Profile.
  2. Scroll down to the "API Access" section.
  3. Click Generate Key to create your unique API Key.

Include your key in the request header as shown below:

X-API-KEY: rdns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your API Key secure. Do not share it publicly. You can regenerate it at any time from your profile if it gets compromised.

Endpoints
  • GET /api/search/<keyword> — keyword search (domain, IP, or CIDR)
  • GET /api/search/query/<query> — advanced query syntax
Request

Method: GET

Access path pattern:

https://rapiddns.io/api/search/<keyword>?page=1&pagesize=100

Query parameters:

  • pagesize — page size per request
  • page — page index to fetch
  • search_type — (Optional) Force search type: subdomain, same_domain, ip, ip_segment. If not provided, it is auto-detected.
Examples

Subdomain search:

https://rapiddns.io/api/search/tesla.com?page=1&pagesize=100

Reverse IP:

https://rapiddns.io/api/search/172.217.3.174?page=1&pagesize=100

Reverse IP range (CIDR):

https://rapiddns.io/api/search/129.134.0.0/16?page=1&pagesize=100
Response

Successful responses return JSON:

{
  "status": 200,
  "msg": "ok",
  "data": {
    "total": 45,
    "status": "ok",
    "data": [
      {
        "type": "A",
        "value": "162.159.0.31",
        "timestamp": "2023-03-02T08:14:42+00:00",
        "date": "2023-03-02",
        "subdomain": "a.ns.hackerone.com"
      },
      {
        "type": "AAAA",
        "value": "2606:4700::6810:6334",
        "timestamp": "2023-02-23T12:17:10+00:00",
        "date": "2023-02-23",
        "subdomain": "hackerone.com"
      }
    ]
  }
}

Fields:

  • data.total — total record count
  • data.data — array of records
  • record.subdomain, record.type, record.value, record.timestamp, record.date
Pagination

Use page and pagesize to paginate results.

Errors
  • 200 Success
  • 400 Parameter error
  • 401 Invalid or expired token
  • 403 Insufficient permissions
  • 404 Not found
  • 429 Rate limit exceeded
  • 5xx Server error
Advanced Query

Use /api/search/query/<query> for syntax-based searches. Queries use Elasticsearch query_string with default operator AND.

Advanced Query Syntax
  • Fields: domain, tld, subdomain, value, type, is_root
  • Boolean: AND, OR, NOT
  • Exact match: wrap in quotes, e.g. subdomain:"a.ns.hackerone.com"
  • Wildcards: trailing wildcards allowed (e.g. subdomain:apple.com*); leading wildcards are not allowed
  • Examples:

domain:apple AND tld:com
type:A AND value:"172.217.3.174"
subdomain:apple.com*
value:"129.134.0.0/16"
Best Practices
  • Retry transient failures with backoff
  • Use reasonable timeouts and caching
  • Paginate consistently to avoid over-fetching