DNS Lookup API Documentation
Domain DNS Information Query API
Category: Web Tools
Endpoint:/v1/websitetools/dns-lookup
Method:GET
Description: Returns data for various record types such as A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA.
Overview
The Domain DNS Information Query API by GuGuData enables real-time DNS record lookups for any public domain. With its rich and flexible data structure, this API reveals a comprehensive suite of DNS records—A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA—all parsed in milliseconds. Designed to handle high concurrency, it is ideal for enterprise-scale applications like domain management, DevOps workflows, content delivery optimization, and more.
Key benefits include:
- Complete DNS record coverage – A single query can retrieve multiple record types.
- Low-latency performance – High-speed lookups with nationwide multi-node CDN support.
- Millisecond parsing – Ideal for real-time monitoring or automation scripts.
- HTTPS/TLS compliance – Fully compatible with Apple ATS and TLS v1.0 through v1.3.
Request URL
GET https://api.gugudata.io/v1/websitetools/dns-lookup
Demo URL
You can test the API using our live demo endpoint:
https://api.gugudata.io/v1/websitetools/dns-lookup/demo
Request Parameters
Send a GET request to the above endpoint with the following query parameters:
| Parameter | Type | Required | Default Value | Description |
appkey | string | Yes | YOUR_APPKEY | Your unique APPKEY obtained from the GuGuData Developer Center. |
domain | string | Yes | YOUR_VALUE | The domain to resolve (e.g., gugudata.com). No https:// prefix needed. |
Response Parameters
The API returns a JSON structure containing the requested DNS record data. Below is an overview of the key fields:
| Parameter | Type | Required | Description |
dataStatus.requestParameter | string | Yes | The requested domain parameter. |
dataStatus.statusCode | integer | Yes | The HTTP status code. |
dataStatus.status | string | Yes | Request status (e.g., OK, Error). |
dataStatus.statusDescription | string | Yes | Description of the request status. |
dataStatus.responseDateTime | string | Yes | The timestamp when the data was returned. |
dataStatus.dataTotalCount | integer | Yes | The total number of returned data items. |
data.* | string | Yes | An array of DNS records, each containing the domain, TTL, class, type, and value. Types include: A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA. |
data.*.domain | string | Yes | The resolved domain. |
data.*.ttl | string | Yes | Time-to-live (TTL) value for the record. |
data.*.class | string | Yes | Record class (typically IN). |
data.*.type | string | Yes | Record type (e.g., A, MX, NS, etc.). |
data.*.value | string | Yes | Actual value or target of the record. |
Error Codes
Below is a list of common error codes you might encounter:
| Error Code | Error Content | Notes |
200 | Normal return | Indicates a successful request. |
400 | Parameter error | Possibly a missing or malformed parameter. |
429 | Request frequency limited | You have exceeded the rate limit of 100 requests/second. |
403 | Account in arrears | Account requires payment; check notifications for billing info. |
402 | APPKEY error | Ensure your APPKEY matches the one in your Developer Center. |
500 | API response error | A server-side error occurred; try again later. |
Features
- Complete DNS resolution – Collects A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA records in one request.
- Rich resolution record types – Ensures flexibility for domain management, server migrations, and troubleshooting.
- Multiple query support – Seamlessly handle numerous domain lookups.
- Millisecond parsing performance – Enables real-time processing in high-concurrency environments.
- HTTPS/TLS (v1.0–v1.3) support – Secure data transfer, fully compatible with Apple ATS.
- Nationwide multi-node CDN – Optimized for low latency and reliable performance.
- Load-balanced infrastructure – High availability even under heavy load.
Additional Notes for Developers
- Domain-only input: Use simple domain names (e.g.,
example.com). Subdomains are supported but do not require thehttps://prefix. - Check concurrency: Monitor usage stats in the Developer Center to avoid hitting the 100 req/sec rate limit.
- Wide use cases: Ideal for DevOps, DNS troubleshooting, multi-CDN strategies, or building dashboards for domain administrators.
Getting Started
- Sign up at GuGuData.io – Create an account to obtain your
appkey. - Construct a GET request – Pass
appkeyanddomainas query parameters. - Inspect the Response – Verify DNS record data in the returned JSON.
- Integrate – Use this information for server setups, domain health checks, or real-time dashboards.
About GuGuData
GuGuData has led the data solutions field for nearly a decade, offering a broad range of APIs — from SSL Certificate Parsing to Webpage Readable Content Extraction. We constantly organize, cleanse, and integrate data, enabling developers, businesses, and analysts to quickly achieve scalable, reliable insights.
Key Highlights:
- Nine years in business – Our stable track record ensures top-tier solutions.
- 4.2k+ APIs – Explore a diverse library of data and functionality.
- 95% happy customers – Trusted by companies worldwide for quality and innovation.
With the Domain DNS Information Query API, gain unparalleled visibility into your DNS configuration and ensure your domains are set up optimally. Visit our official website to discover more groundbreaking data services.