DEV Community

GuGuData
GuGuData

Posted on

Domain DNS Information Query API by GuGuData: Get Complete DNS Records for Any Domain

Domain DNS Information Query API by GuGuData: Get Complete DNS Records for Any Domain

GuGuData's Domain DNS Information Query API is a fast and reliable tool for retrieving detailed DNS resolution records for any domain. With support for multiple DNS record types and millisecond response times, this API ensures you get the DNS information you need for domain analysis, security, or troubleshooting.

Why Choose GuGuData’s DNS Information Query API?

Our DNS Information Query API provides a range of features that make it the ideal choice for DNS record retrieval:

1. Rich Information Structure

The API provides complete DNS resolution records, including A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, and SOA records. This allows for a comprehensive understanding of a domain's DNS configuration.

2. Millisecond Response Time

With support for high concurrency, the API delivers DNS record information in milliseconds, ensuring quick and accurate data retrieval.

3. Supports Multiple Record Types

Retrieve multiple DNS record types in a single query. Whether you're analyzing mail server configurations (MX records), IP addresses (A and AAAA records), or DNS security settings (TXT records), the API handles it all.

4. Nationwide CDN Deployment

Our API is deployed across multiple CDN nodes nationwide, ensuring fast access with minimal latency.


Key Features

  • Complete DNS Records: Retrieve all major DNS record types for any domain.
  • Multiple Record Types: Support for A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA records.
  • Millisecond Response Time: High-performance parsing with support for high concurrency.
  • Nationwide CDN: Reliable access via multi-node CDN deployment.
  • HTTPS and TLS Support: Full HTTPS and TLS (v1.0 / v1.1 / v1.2 / v1.3) support.
  • Apple ATS Compatible: Fully compatible with Apple's App Transport Security.
  • Load Balancing: Optimized performance through multi-server load balancing.

API Documentation

The DNS Information Query API is easy to integrate with your existing systems. Below are the implementation details:

API Endpoint

To retrieve DNS records for a domain, make a GET request to the following endpoint:

GET https://api.gugudata.io/v1/websitetools/dns-lookup
Enter fullscreen mode Exit fullscreen mode

For testing purposes, you can use our demo endpoint:

https://api.gugudata.io/v1/websitetools/dns-lookup/demo
Enter fullscreen mode Exit fullscreen mode

Request Parameters

Parameter Name Type Required Default Value Description
appkey string Yes YOUR_APPKEY The APPKEY obtained after registration.
domain string Yes YOUR_VALUE The domain to retrieve the DNS records for (e.g., gugudata.com).

Sample Request

GET https://api.gugudata.io/v1/websitetools/dns-lookup?appkey=YOUR_APPKEY&domain=gugudata.com
Enter fullscreen mode Exit fullscreen mode

Response Parameters

Parameter Name Type Description
dataStatus.requestParameter string The requested domain parameter.
dataStatus.statusCode int The HTTP status code of the response.
dataStatus.status string The request status.
dataStatus.statusDescription string Description of the request status.
dataStatus.responseDateTime string The timestamp of the response.
dataStatus.dataTotalCount int Total number of returned data.
data.*.domain string The resolved domain name.
data.*.ttl string The Time To Live (TTL) value of the DNS record.
data.*.class string The class of the DNS record.
data.*.type string The type of the DNS record (A, AAAA, MX, etc.).
data.*.value string The value of the DNS record.

Sample Response

{
    "dataStatus": {
        "requestParameter": "gugudata.com",
        "statusCode": 200,
        "status": "success",
        "statusDescription": "Normal return",
        "responseDateTime": "2024-02-29T00:00:00Z",
        "dataTotalCount": 9
    },
    "data": [
        {
            "domain": "gugudata.com",
            "ttl": "3600",
            "class": "IN",
            "type": "A",
            "value": "192.168.0.1"
        },
        {
            "domain": "gugudata.com",
            "ttl": "3600",
            "class": "IN",
            "type": "MX",
            "value": "mail.gugudata.com"
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

API Error Codes

Error Code Description Remarks
200 Normal return Successful API call.
400 Parameter error Check if all required parameters are provided.
429 Request frequency limited Cannot exceed 100 requests per second.
403 Account in arrears Account has expired; please renew your subscription.
402 APPKEY error Verify that the APPKEY is correct and active.
500 API response error General API error; contact support if it persists.

How to Get Started

  1. Obtain Your APPKEY: Register at GuGuData to obtain your APPKEY for API authentication.

  2. Submit Domain Name: Provide the domain name for which you want to retrieve DNS information.

  3. Make a GET Request: Send a GET request to the API endpoint with the required parameters.

  4. Retrieve DNS Records: Receive the DNS resolution records for the domain you submitted.

  5. Integrate and Automate: Incorporate the API into your domain management or security analysis workflows.


Use Cases

  • Domain Analysis: Retrieve complete DNS records to understand a domain's configuration.
  • Email Configuration: Verify MX records to ensure proper mail server configuration.
  • Security Audits: Check TXT records for DNS security settings like SPF and DKIM.
  • Domain Troubleshooting: Analyze DNS issues by retrieving the full range of DNS records for a domain.

Conclusion

GuGuData's Domain DNS Information Query API is a powerful tool for retrieving DNS records quickly and accurately. With support for multiple record types, millisecond response times, and multi-node CDN deployment, this API is ideal for anyone needing comprehensive DNS information for domain management or analysis.

Get started with GuGuData's Domain DNS Information Query API today! and streamline your domain analysis with ease.

Top comments (0)