DNS Spy DNS Spy
Features Pricing API Free Tools Learn Blog Contact
Log in

Embed DNS Resolver Widget

Display real-time DNS resolver information on your website with our free embeddable widget. Show performance metrics, reliability scores, and features to your visitors.

Widget Configuration

Display a single resolver by IP address

Display all resolvers from an organization

Required: Please specify either a resolver IP address or an organization name.

How to Use

  1. Configure your widget using the form above. Choose either a specific resolver IP address or an organization name.
  2. Customize the appearance by selecting a theme (light or dark) and choosing which fields to display.
  3. Copy the generated code from the "Generated Embed Code" section.
  4. Paste the code into your website's HTML where you want the widget to appear.
  5. Preview the widget using the "Show Preview" button to see how it will look on your site.

Configuration Options

  • data-resolver - Display a single resolver by IP address
  • data-organization - Display all resolvers from an organization (up to 10)
  • data-theme - Choose "light" or "dark" theme
  • data-fields - Comma-separated list of fields to display

Example Usage

<!-- Display Google's DNS resolver -->
<script src="https://dnsspy.io/dns-tools/public-dns-servers-list/embed.js" 
        data-resolver="8.8.8.8" 
        data-theme="light"></script>

<!-- Display all Cloudflare resolvers -->
<script src="https://dnsspy.io/dns-tools/public-dns-servers-list/embed.js" 
        data-organization="Cloudflare" 
        data-theme="dark"></script>

API Documentation

Get Single Resolver Data

Retrieve information about a specific DNS resolver by IP address.

GET /api/embed/resolver/{ip}

Parameters

  • ip - The IP address of the resolver (IPv4 or IPv6)

Example Request

curl https://dnsspy.io/api/embed/resolver/8.8.8.8

Example Response

{
  "ip": "8.8.8.8",
  "ip_version": 4,
  "reliability_score": 99.9,
  "status": "online",
  "avg_response_time_ms": 15,
  "features": {
    "DoH": true,
    "DoT": false,
    "IPv6": true
  },
  "country_code": "US",
  "country_name": "United States",
  "city": "Mountain View",
  "asn_org": "Google LLC",
  "last_checked_at": "2026-02-24T12:00:00Z"
}

Get Resolvers by Organization

Retrieve up to 10 resolvers from a specific organization.

GET /api/embed/organization/{org}

Parameters

  • org - The organization name (partial match supported)

Example Request

curl https://dnsspy.io/api/embed/organization/Cloudflare

Example Response

{
  "resolvers": [
    {
      "ip": "1.1.1.1",
      "ip_version": 4,
      "reliability_score": 99.9,
      "status": "online",
      "avg_response_time_ms": 12,
      "features": {
        "DoH": true,
        "DoT": true,
        "IPv6": true
      }
    },
    {
      "ip": "1.0.0.1",
      "ip_version": 4,
      "reliability_score": 99.8,
      "status": "online",
      "avg_response_time_ms": 13,
      "features": {
        "DoH": true,
        "DoT": true,
        "IPv6": true
      }
    }
  ]
}

Rate Limiting

The widget API endpoints are rate limited to ensure fair usage and system stability.

  • 100 requests per minute per IP address
  • 1000 requests per hour per IP address

Note: When rate limits are exceeded, the API will return a 429 status code with a Retry-After header indicating when you can retry the request.

CORS Support

The widget API endpoints support Cross-Origin Resource Sharing (CORS), allowing you to make requests from any domain.

All widget API endpoints include the Access-Control-Allow-Origin: * header, enabling cross-origin requests from any website.

Browse All Public DNS Servers

Explore our complete list of public DNS servers with real-time performance metrics, reliability scores, and geographic information.

View DNS Servers List
DNS Spy

Features

Resources

Company