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.

Why embed it

If your readers ask which DNS server to use, this widget answers with live data instead of a list that was true the day the page was written. Pick a resolver by IP or by name, choose light or dark, and keep the fields you want: address, reliability score, current status, features such as DNSSEC and ad blocking, location, and response time. The numbers come from DNS Spy's own query nodes and refresh on their own, so the widget stays correct after you publish.

It fits hosting and ISP help pages, router and firmware wikis, privacy guides, and any article that recommends a public DNS server. The code is one script tag and one container. There is nothing to install, nothing to maintain, and no account needed.

Attribution

The widget is free to use on any site, commercial or not, on one condition: the small "Powered by DNS Spy" line at the bottom stays visible and linked. That line is how the data pays for itself. Hide it and the widget is no longer licensed for your page.

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