> API Documentation_
Integrate DNS intelligence into your applications.
# Overview
The DNSRift API provides DNS intelligence data via a simple REST API returning JSON responses.
Base URL
https://api.dnsrift.net
Format
JSON
Method
GET
# Reverse IP Lookup
Discover domain names hosted on a specific IP address.
Endpoint
GET
https://api.dnsrift.net/reverse-ip-lookup?ip=x.x.x.xWith API Key (paid plans)
GET
https://api.dnsrift.net/reverse-ip-lookup?ip=x.x.x.x&key=xxxxxxxxxParameters
| Param | Type | Required | Description |
|---|---|---|---|
ip | string | Yes | Target IPv4 or IPv6 address |
key | string | No | API key for paid plans |
limit | integer | No | Max results to return (capped by plan) |
Result Limits per Plan
| Plan | Max Results per Request |
|---|---|
| Free | 100,000 |
| Professional | 500,000 |
| Enterprise | Unlimited |
Example Responses
Valid IP with domains:
200 OK
{
"ip": "12.12.12.12",
"plan": "free",
"domain_count": 2,
"max_results": 100000,
"limit": 100000,
"domain_list": [
"xxies.site",
"smartpayonline.co.in"
]
}With custom limit:
GET
https://api.dnsrift.net/reverse-ip-lookup?ip=8.8.8.8&limit=500Valid IP without domains:
200 OK
{
"ip": "5.6.7.7",
"plan": "free",
"domain_count": 0,
"max_results": 100000,
"limit": 100000,
"domain_list": []
}Invalid IP format:
400 Bad Request
{
"domain_list": [],
"message": "Invalid IP format"
}# Subdomain Lookup
Enumerate subdomains for a target domain.
Endpoint
GET
https://api.dnsrift.net/subdomain-lookup?domain=example.comWith API Key (paid plans)
GET
https://api.dnsrift.net/subdomain-lookup?domain=example.com&key=xxxxxxxxxParameters
| Param | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Target domain name |
key | string | No | API key for paid plans |
limit | integer | No | Max results to return (capped by plan) |
Example Response
200 OK
{
"target_domain": "example.com",
"plan": "free",
"count": 3,
"max_results": 100000,
"limit": 100000,
"subdomains": [
"www.example.com",
"mail.example.com",
"blog.example.com"
]
}Invalid domain:
400 Bad Request
{
"subdomains": [],
"message": "Invalid domain format"
}# Authentication
The free tier does not require an API key. Simply make requests to the endpoint.
For paid plans, append your API key as a query parameter:
Example
curl "https://api.dnsrift.net/reverse-ip-lookup?ip=8.8.8.8&key=dnsrift_xxxxxxxxxxxxxxxxxxxx"Your API key is available in your Dashboard after subscribing to a paid plan.
# Rate Limits
| Plan | Request Limit | Period | Results per Request | API Key |
|---|---|---|---|---|
| Free | 100,000 | Day | 100,000 | Not required |
| Professional | 1,000,000 | Month | 500,000 | Required |
| Enterprise | 3,000,000 | Month | Unlimited | Required |
Rate Limit Headers
Response Headers
X-RateLimit-Limit: 100000
X-RateLimit-Remaining: 99842
X-RateLimit-Plan: free# Code Examples
Python
python
import requests
response = requests.get("https://api.dnsrift.net/reverse-ip-lookup", params={"ip": "8.8.8.8"})
data = response.json()
for domain in data.get("domain_list", []):
print(domain)JavaScript
javascript
const res = await fetch("https://api.dnsrift.net/reverse-ip-lookup?ip=8.8.8.8");
const data = await res.json();
console.log(data.domain_list);cURL
bash
curl -s "https://api.dnsrift.net/reverse-ip-lookup?ip=8.8.8.8" | jq .