# 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](https://gugudata.io/) 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](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

1. **Complete DNS resolution** – Collects **A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA** records in one request.
2. **Rich resolution record types** – Ensures flexibility for domain management, server migrations, and troubleshooting.
3. **Multiple query support** – Seamlessly handle numerous domain lookups.
4. **Millisecond parsing performance** – Enables real-time processing in high-concurrency environments.
5. **HTTPS/TLS (v1.0–v1.3) support** – Secure data transfer, fully compatible with Apple ATS.
6. **Nationwide multi-node CDN** – Optimized for low latency and reliable performance.
7. **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 the `https://` 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

1. **Sign up at [GuGuData.io](https://gugudata.io/)** – Create an account to obtain your `appkey`.
2. **Construct a GET request** – Pass `appkey` and `domain` as query parameters.
3. **Inspect the Response** – Verify DNS record data in the returned JSON.
4. **Integrate** – Use this information for server setups, domain health checks, or real-time dashboards.

## About GuGuData

[**GuGuData**](https://gugudata.io/) has led the **data solutions** field for nearly a decade, offering a **broad range of APIs** — from [SSL Certificate Parsing](https://gugudata.io/) to [Webpage Readable Content Extraction](https://gugudata.io/). 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](https://gugudata.io/) to discover more groundbreaking data services.