https://github.com/apiverve/dns-lookup-go-tutorial
DNS lookup tool that retrieves DNS records using Go
https://github.com/apiverve/dns-lookup-go-tutorial
apiverve cli devops dns dns-lookup go golang networking tutorial
Last synced: about 13 hours ago
JSON representation
DNS lookup tool that retrieves DNS records using Go
- Host: GitHub
- URL: https://github.com/apiverve/dns-lookup-go-tutorial
- Owner: apiverve
- License: mit
- Created: 2026-02-16T06:24:01.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-16T07:40:32.000Z (4 months ago)
- Last Synced: 2026-02-16T14:17:58.159Z (4 months ago)
- Topics: apiverve, cli, devops, dns, dns-lookup, go, golang, networking, tutorial
- Language: Go
- Homepage: https://apiverve.com/marketplace/dnslookup
- Size: 14.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DNS Lookup Tool | APIVerve API Tutorial
[](LICENSE)
[]()
[](https://go.dev)
[](https://apiverve.com/marketplace/dnslookup?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial)
A Go CLI tool that looks up DNS records for any domain. View A, AAAA, MX, TXT, NS, and CNAME records.
---
### Get Your Free API Key
This tutorial requires an APIVerve API key. **[Sign up free](https://dashboard.apiverve.com?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial)** - no credit card required.
---
## Features
- Look up all DNS record types
- View A records (IPv4 addresses)
- View AAAA records (IPv6 addresses)
- View MX records with priorities
- View NS records (nameservers)
- View TXT records (SPF, DKIM, etc.)
- View CNAME records
- Interactive mode or command-line arguments
- No external dependencies (standard library only)
## Quick Start
1. **Clone this repository**
```bash
git clone https://github.com/apiverve/dns-lookup-go-tutorial.git
cd dns-lookup-go-tutorial
```
2. **Add your API key**
Open `main.go` and replace the API key:
```go
const apiKey = "your-api-key-here"
```
3. **Run the tool**
Interactive mode:
```bash
go run main.go
```
Command line mode:
```bash
go run main.go google.com
```
4. **Build executable (optional)**
```bash
go build -o dns-lookup main.go
./dns-lookup google.com
```
## Usage Examples
### Look up a domain
```bash
$ go run main.go github.com
=======================================================
DNS Records: github.com
=======================================================
A Records (IPv4)
---------------------------------------------------
140.82.112.3
140.82.112.4
AAAA Records (IPv6)
---------------------------------------------------
(none)
MX Records (Mail)
---------------------------------------------------
[1] aspmx.l.google.com
[5] alt1.aspmx.l.google.com
[10] alt2.aspmx.l.google.com
NS Records (Nameservers)
---------------------------------------------------
dns1.p08.nsone.net
dns2.p08.nsone.net
dns3.p08.nsone.net
dns4.p08.nsone.net
TXT Records
---------------------------------------------------
v=spf1 include:_spf.google.com include:servers...
MS=ms12345678
=======================================================
```
## Project Structure
```
dns-lookup-go-tutorial/
├── main.go # Main Go source file
├── go.mod # Go module file
├── screenshot.jpg # Preview image
├── LICENSE # MIT license
├── .gitignore # Git ignore rules
└── README.md # This file
```
## How It Works
1. User provides a domain name
2. Go program cleans the input
3. HTTP request sent to DNS Lookup API
4. JSON response parsed into Go structs
5. Records displayed in formatted output
### The API Call
```go
req, _ := http.NewRequest("GET", apiURL+"?domain="+domain, nil)
req.Header.Set("x-api-key", apiKey)
client := &http.Client{}
resp, _ := client.Do(req)
```
## API Reference
**Endpoint:** `GET https://api.apiverve.com/v1/dnslookup`
**Query Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain to look up (e.g., "google.com") |
**Example Response:**
```json
{
"status": "ok",
"error": null,
"data": {
"domain": "myspace.com",
"records": {
"A": ["34.111.176.156"],
"MX": [
{"exchange": "us-smtp-inbound-1.mimecast.com", "priority": 10},
{"exchange": "us-smtp-inbound-2.mimecast.com", "priority": 10}
],
"NS": [
"ns-cloud-a1.googledomains.com",
"ns-cloud-a2.googledomains.com"
],
"TXT": ["v=spf1 mx ip4:63.208.226.34 ..."]
}
}
}
```
## DNS Record Types
| Type | Description |
|------|-------------|
| A | IPv4 address |
| AAAA | IPv6 address |
| MX | Mail exchange (email servers) |
| NS | Nameservers |
| TXT | Text records (SPF, DKIM, verification) |
| CNAME | Canonical name (alias) |
## Use Cases
- **Network diagnostics** - Troubleshoot DNS issues
- **Email setup** - Verify MX records
- **Security checks** - Review SPF/DKIM records
- **Domain migration** - Verify DNS propagation
- **DevOps** - Automate DNS verification
## Customization Ideas
- Add JSON output format
- Query specific record types only
- Compare DNS across multiple resolvers
- Build a web interface
- Add DNS propagation checking
- Export results to file
## Related APIs
Explore more APIs at [APIVerve](https://apiverve.com/marketplace?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial):
- [SSL Checker](https://apiverve.com/marketplace/sslchecker?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - Check SSL certificates
- [WHOIS Lookup](https://apiverve.com/marketplace/whoislookup?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - Domain registration info
- [MX Lookup](https://apiverve.com/marketplace/mxlookup?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - Mail server lookup
## Free Plan Note
This tutorial works with the free APIVerve plan. Some APIs may have:
- **Locked fields**: Premium response fields return `null` on free plans
- **Ignored parameters**: Some optional parameters require a paid plan
The API response includes a `premium` object when limitations apply. [Upgrade anytime](https://dashboard.apiverve.com/plans) to unlock all features.
## License
MIT - see [LICENSE](LICENSE)
## Links
- [Get API Key](https://dashboard.apiverve.com?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - Sign up free
- [APIVerve Marketplace](https://apiverve.com/marketplace?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - Browse 300+ APIs
- [DNS Lookup API](https://apiverve.com/marketplace/dnslookup?utm_source=github&utm_medium=tutorial&utm_campaign=dns-lookup-go-tutorial) - API details