Name: WhoisFreaks – Domain & IP Lookup | Free · $10/mo | API.market
Brand: whoisfreaks
SKU: api-whoisfreaks-whois-api
Availability: InStock
Author: API Market

Shashank Agarwal

## 🌐🔎  WHOIS & DNS API: Real-Time Domain & IP Lookup

**Empower Your Cybersecurity Strategy with Real-Time Domain and IP Intelligence**  
Welcome to the WHOIS & DNS Data API, now accessible via API.market. Whether you’re a cybersecurity professional, brand manager, researcher, or digital marketer, our robust set of endpoints helps you monitor domain registrations, track DNS changes, investigate IP ownership, and protect your digital assets.

---

## Getting Started
1. **Sign up** at the API.market to obtain your **x-magicapi-key** (an active subscription is required).  
2. **Include** this header in every request:
   ```
   accept: application/json
   x-magicapi-key: YOUR_API_MARKET_KEY
   ```
3. **Integrate** any of the following endpoints into your system to begin querying domain and IP data.

All endpoints return JSON and use the **GET** method. Below, find a concise guide to each endpoint, followed by an integrated **Endpoint & Example** section.

---

## Core Capabilities
- **WHOIS Lookup (Live, Historical, Reverse)**: Gain insights into domain ownership, registrant details, and domain life cycle.  
- **DNS Records (Live, Historical, Reverse)**: Fetch DNS records (A, AAAA, MX, NS, CNAME, TXT, SPF, SOA) to spot security threats or verify configurations.  
- **IP WHOIS & ASN WHOIS**: Identify network ownership, discover corporate details, and investigate abuse or spam sources.  
- **Domain Availability**: Quickly check if a domain is registered, and get domain suggestions for your next big idea.  
- **SSL Certificate Info**: Validate a domain’s SSL certificate details, including expiry, issuer, and public key data.

---

## Common Use Cases
- **Brand Protection**: Identify domains infringing on your trademarks, and contact registrants to address the issue.  
- **Security Investigations**: Monitor newly registered domains for potential phishing campaigns, and investigate IP or ASN owners behind malicious activity.  
- **Network Troubleshooting**: Validate DNS configurations, routing issues, and SSL setups in real time.  
- **Competitive Research**: Explore domain footprints, ownership changes, or expansions in targeted verticals.

---

## 1) WHOIS Lookup

Retrieve **live**, **historical**, or **reverse** WHOIS data for any domain. Pinpoint ownership changes, contact info, registration details, and more.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v1.0/whois?whois=live&domainName=api.market&keyword=whois&email=abc%40xyz.com&owner=ejaz&company=jfreaks&mode=mini&page=1" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Query Parameters**  
  - `whois` (required): `live`, `historical`, or `reverse`  
  - `domainName`: Domain to retrieve WHOIS data for (when `whois=live` or `whois=historical`)  
  - `keyword`, `email`, `owner`, `company`: Used for reverse WHOIS searches  
  - `mode`: For reverse WHOIS, e.g., `mini`  
  - `page`: Paginate results (integer)

**Sample Response**  
```json
{
  "status": true,
  "domain_name": "api.market",
  "query_time": "2025-02-21 13:03:30",
  "whois_server": "whois.verisign-grs.com",
  "domain_registered": "yes",
  "create_date": "2019-03-19",
  "update_date": "2025-02-18",
  "expiry_date": "2026-03-19",
  "domain_registrar": {
    "iana_id": "1068",
    "registrar_name": "NAMECHEAP INC",
    "whois_server": "whois.namecheap.com",
    "website_url": "http://www.namecheap.com",
    "email_address": "abuse@namecheap.com",
    "phone_number": "+1.9854014545"
  },
  "name_servers": [
    "dns3.cloudns.net",
    "dns4.cloudns.net"
  ],
  "domain_status": [
    "clientTransferProhibited"
  ]
}
```

---

## 2) DNS Records

Fetch **live**, **historical**, or **reverse** DNS data. Investigate name servers, mail exchangers (MX), and more.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v2.0/dns/live?domainName=api.market&value=8.8.8.8&type=a&page=1" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Path Parameter**  
  - `{live|historical|reverse}` (replaces `{data_type}`)
- **Query Parameters**  
  - `domainName`: Domain to retrieve DNS records for  
  - `value`: Reverse DNS lookup value (IP, etc.)  
  - `type` (required): `A`, `AAAA`, `MX`, `NS`, `CNAME`, `TXT`, `SPF`, `SOA`, or `all`  
  - `page`: Paginate results (integer)

**Sample Response**  
```json
{
  "status": true,
  "queryTime": "2025-02-21 12:49:43",
  "domainName": "api.market",
  "dnsRecords": [
    {
      "name": "api.market",
      "dnsType": "A",
      "ttl": 3600,
      "address": "172.233.38.245"
    },
    {
      "name": "api.market",
      "dnsType": "MX",
      "ttl": 3600,
      "target": "mx.mailserver.com.",
      "priority": 10
    }
  ]
}
```

---

## 3) SSL Certificate Information

Inspect a domain’s **live SSL certificate**—including issuer details, validity period, and more.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v1.0/ssl/live?domainName=api.market&chain=false&sslRaw=false" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Query Parameters**  
  - `domainName` (required): The domain to inspect  
  - `chain`: `true` returns certificate chain details  
  - `sslRaw`: `true` returns raw certificate data

**Sample Response**  
```json
{
  "domainName": "api.market",
  "queryTime": "2025-02-21 13:03:18",
  "sslCertificates": [
    {
      "chainOrder": "end-user",
      "validityStartDate": "2025-02-06 23:04:42 UTC",
      "validityEndDate": "2025-05-07 23:04:41 UTC",
      "issuer": {
        "commonName": "E6",
        "organization": "Let's Encrypt",
        "country": "US"
      },
      "subjectAlternativeNames": {
        "dnsNames": [
          "api.market",
          "www.api.market"
        ]
      }
    }
  ]
}
```

---

## 4) IP WHOIS Lookup

Uncover ownership details and administrative contacts for any IPv4 or IPv6 address.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v1.0/ip-whois?ip=8.8.8.8" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Query Parameter**  
  - `ip` (required): IP address to lookup

**Sample Response**  
```json
{
  "status": true,
  "ip_address": "8.8.8.8",
  "query_time": "2025-02-21 13:05:56",
  "organization": {
    "handle": "GOGL",
    "name": "Google LLC",
    "address": [
      "1600 Amphitheatre Parkway",
      "Mountain View",
      "CA",
      "94043",
      "US"
    ]
  },
  "technical_contacts": [
    {
      "handle": "ZG39-ARIN",
      "name": "Google LLC",
      "email": [
        "arin-contact@google.com"
      ],
      "phone": [
        "+1-650-253-0000"
      ]
    }
  ]
}
```

---

## 5) ASN WHOIS Lookup

Retrieve WHOIS information for a specific Autonomous System Number (ASN). Perfect for identifying network boundaries and owners.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v1.0/asn-whois?asn=AS56554" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Query Parameter**  
  - `asn` (required): e.g., `AS56554`

**Sample Response**  
```json
{
  "status": true,
  "as_number": "AS56554",
  "query_time": "2025-02-21 13:06:47",
  "organization": {
    "handle": "ORG-IS136-RIPE",
    "name": "Internet Society",
    "address": [
      "Galerie Jean-Malbuisson 15, CH-1204 Geneva, Switzerland"
    ]
  }
}
```

---

## 6) Domain Availability

Quickly check if a domain is registered, and optionally retrieve multiple suggestions for alternative domains.

### Endpoint & Example Request
```
curl -X GET \
  "https://api.magicapi.dev/api/v1/whoisfreaks/whois-api/v1.0/domain/availability?domain=api.market&sug=false&count=6" \
  -H "accept: application/json" \
  -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```
- **Query Parameters**  
  - `domain` (required): The domain to check  
  - `sug`: `true` returns alternative domain suggestions  
  - `count`: Number of suggestions to return

**Sample Response**  
```json
{
  "domain": "api.market",
  "domainAvailability": false
}
```

---

## Error Handling

Expect standard HTTP status codes to signal request status:
- **400 – Bad Request**: Invalid or missing parameters  
- **401 – Unauthorized**: Check your API key  
- **408 – Request Timeout**: Data retrieval took too long  
- **429 – Too Many Requests**: You’ve hit your rate limit  
- **500 – Internal Server Error**: Server-side issue; contact support

**Example Error Response**  
```json
{
  "timestamp": "2025-02-21T13:47:02.486Z",
  "status": 401,
  "error": "Api Access Exception",
  "message": "Provided API key is invalid. [For Technical Support: support@api.market]",
  "path": "/v1.0/whois"
}
```

---

## Best Practices
1. **Paginate Large Results** with `page` to handle extensive reverse lookups.  
2. **Rate Limiting**: Prevent 429 errors by monitoring your request frequency.  
3. **Automation**: Integrate with SIEMs or threat intelligence platforms to monitor domains and IPs continuously.  
4. **Combine WHOIS & DNS**: For deeper research, correlate changes over time in both domain registration and DNS records.  

---

## Get More Out of API.market

With **API.market’s** WHOIS & DNS Data API, you gain global coverage of TLDs, robust daily updates, and advanced security insights. Simplify brand protection, mitigate threats, and make informed decisions backed by real-time, reliable data.

**Need Help?** Just send us a message using the chat on the bottom right corner.

**Start using the WHOIS & DNS Data API today** and strengthen your domain intelligence strategy with minimal effort and maximum impact.

Look up domain ownership, IP WHOIS data, and DNS records. Free 500 calls/mo, from $10/mo. Start free on API.market.

WhoisFreaks – Domain & IP Lookup | Free · $10/mo | API.market

FREE

whoisfreaks