WHOIS और RDAP लुकअप API
RDAP के ज़रिए सीधे आधिकारिक रजिस्ट्री से किसी भी डोमेन, IP पते या ऑटोनॉमस सिस्टम नंबर का पंजीकरण डेटा। रजिस्ट्रार, नेमसर्वर, DNSSEC, समाप्ति तिथियाँ और दुरुपयोग संपर्क सपाट JSON के रूप में।
API key नहीं है?
अपनी API keys बनाने और मैनेज करने के लिए अपने खाते में साइन इन करें।
इंटीग्रेशन गाइड
एक snippet कॉपी करें, अपनी API key बदलें, रन करें। किसी भी HTTP क्लाइंट में काम करता है — नीचे cURL, JavaScript और Python में उदाहरण।
/api/whoishttps://www.apipick.comRegistration data for a domain, IP address, or AS number
querystringआवश्यकA domain name, IPv4/IPv6 address, or AS number. The type is detected automatically. github.com
curl -X GET "https://www.apipick.com/api/whois" \
-H "x-api-key: YOUR_API_KEY"{
"query": "github.com",
"type": "domain",
"found": true,
"domain": "github.com",
"unicode_domain": null,
"nameservers": [
"dns1.p08.nsone.net",
"ns-421.awsdns-52.com"
],
"dnssec": false,
"handle": "1264983250_DOMAIN_COM-VRSN",
"status": [
"client delete prohibited",
"client transfer prohibited"
],
"country": null,
"registrar": "MarkMonitor Inc.",
"registered_at": "2007-10-09T18:20:50Z",
"updated_at": "2024-09-07T09:16:32Z",
"expires_at": "2026-10-09T18:20:50Z",
"contacts": [
{
"roles": [
"registrar"
],
"handle": "292",
"name": "MarkMonitor Inc.",
"organization": null,
"email": null,
"phone": null,
"address": null,
"country": null
}
],
"source": "RDAP (IANA bootstrap via rdap.org)",
"credits_used": 2,
"remaining_credits": 98
}वास्तविक उपयोग के मामलों के लिए बनाया गया
समाप्ति निगरानी
अपने डोमेन पोर्टफ़ोलियो की नियमित जाँच करें और नवीनीकरण तिथियों से पहले चेतावनी दें। रजिस्ट्री का लाइव डेटा, इसलिए कैश चक्र से कुछ भी पुराना नहीं पड़ता।
डोमेन ड्यू डिलिजेंस
किसी प्रतिपक्ष के डोमेन पर भरोसा करने या आपूर्तिकर्ता को मंज़ूरी देने से पहले पंजीकरण की आयु, रजिस्ट्रार और स्टेटस कोड जाँचें।
दुरुपयोग की शिकायत
किसी IP या ASN को उसके धारक और दुरुपयोग संपर्क तक पहुँचाएँ, ताकि स्वचालित शिकायतें ऐसे मेलबॉक्स में पहुँचें जिसे कोई वाकई पढ़ता हो।
एजेंट के लिए डेटा संवर्धन
एक ही पैरामीटर डोमेन, IP और ASN तीनों को कवर करता है, जिससे LLM के लिए यह एक साफ़-सुथरी टूल परिभाषा बन जाती है।
प्रतिक्रिया फ़ील्ड
| फ़ील्ड | प्रकार | विवरण |
|---|---|---|
| type | string | पहचाना गया क्वेरी प्रकार: domain, ip या autnum |
| found | boolean | जब वस्तु पंजीकृत या आवंटित न हो तो false |
| registrar | string | null | प्रायोजक रजिस्ट्रार (डोमेन) |
| registered_at | string | null | ISO 8601 प्रारूप में पंजीकरण तिथि |
| expires_at | string | null | ISO 8601 प्रारूप में समाप्ति तिथि (डोमेन) |
| updated_at | string | null | अभिलेख में अंतिम परिवर्तन की ISO 8601 तिथि |
| status | string[] | EPP स्टेटस कोड, जैसे client transfer prohibited |
| nameservers | string[] | प्रत्यायोजित नेमसर्वर (डोमेन) |
| dnssec | boolean | null | क्या प्रत्यायोजन DNSSEC से हस्ताक्षरित है |
| cidr | string[] | आवंटन के CIDR खंड (IP क्वेरी) |
| asn | integer | null | ऑटोनॉमस सिस्टम नंबर (ASN क्वेरी) |
| contacts[] | object[] | भूमिका, संगठन, ईमेल और फ़ोन सहित समतल की गई jCard इकाइयाँ |
| credits_used | integer | इस request के लिए काटे गए credits |
| remaining_credits | integer | आपके अकाउंट में शेष credits |
Rate limits
थ्रॉटलिंग प्रति API key है, 60-सेकंड की स्लाइडिंग विंडो। लिमिट पार करने पर आपको Retry-After हेडर के साथ साफ़ 429 मिलता है।
30req/min
प्रति API key, प्रति endpoint। 60-सेकंड की स्लाइडिंग विंडो।
3concurrent
प्रति API key अधिकतम एक साथ चल रहे requests।
X-RateLimit-Limitप्रति मिनट अनुमत अधिकतम requestsX-RateLimit-Remainingमौजूदा विंडो में शेष requestsX-RateLimit-Resetमौजूदा विंडो रीसेट होने में सेकंडRetry-Afterपुनः प्रयास से पहले प्रतीक्षा के सेकंड (केवल 429 पर)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}डेटा स्रोत और लाइसेंस
अभिलेख हर वस्तु की आधिकारिक रजिस्ट्री से आते हैं — डोमेन के लिए Verisign, Nominet और अन्य रजिस्ट्री संचालक; IP श्रेणियों और AS नंबरों के लिए ARIN, RIPE NCC, APNIC, LACNIC तथा AFRINIC — जिन्हें IANA के RDAP बूटस्ट्रैप से हल किया जाता है। कुछ भी कैश या पुनःप्रकाशित नहीं होता: अनुरोध के समय रजिस्ट्री जो देती है, वही आप देखते हैं।
अक्सर पूछे जाने वाले प्रश्न
प्र: यह पारंपरिक WHOIS से किस तरह अलग है?
उ: RDAP, पोर्ट 43 वाले WHOIS के स्थान पर IETF द्वारा बनाया गया विकल्प है। जहाँ WHOIS हर रजिस्ट्री में अलग दिखने वाला मुक्त पाठ लौटाता है जिसे स्क्रैप करना पड़ता है, वहीं RDAP मानक स्कीमा वाला संरचित JSON, HTTPS पर और सही 404 के साथ लौटाता है। हम IANA बूटस्ट्रैप से आधिकारिक रजिस्ट्री को क्वेरी करते हैं और jCard संपर्क खंडों को सादे ऑब्जेक्ट में समतल कर देते हैं।
प्र: पंजीकरणकर्ता के संपर्क प्रायः क्यों गायब रहते हैं?
उ: GDPR के बाद से अधिकांश gTLD रजिस्ट्रियाँ सार्वजनिक RDAP में पंजीकरणकर्ता का नाम, ईमेल और पता छिपा देती हैं और केवल प्रायोजक रजिस्ट्रार तथा एक दुरुपयोग संपर्क प्रकाशित करती हैं। यह छिपाव रजिस्ट्री का ही उत्तर है, इस API की कमी नहीं — जो डेटा रजिस्ट्री प्रकाशित नहीं करती, उसे कोई भी WHOIS प्रदाता नहीं दिखा सकता।
प्र: क्या यह IP पतों और AS नंबरों के लिए भी काम करता है?
उ: हाँ। IPv4 या IPv6 पता दें और आवंटित नेटवर्क, उसके CIDR खंड, धारक तथा RIR हैंडल पाएँ; AS13335 या 13335 दें और AS का नाम तथा उसके धारक, दुरुपयोग एवं तकनीकी संपर्क पाएँ। क्वेरी का प्रकार इनपुट से ही पहचान लिया जाता है, इसलिए एक ही पैरामीटर तीनों स्थितियाँ संभालता है।
प्र: अपंजीकृत डोमेन पर क्या लौटता है?
उ: found: false के साथ HTTP 200। यह एक वास्तविक उत्तर है — उपलब्धता इसी तरह जाँची जाती है — इसलिए सामान्य क्रेडिट लगता है। 2xx से बाहर का कोड केवल ऊपरी स्रोत की विफलता (रजिस्ट्री टाइमआउट, दर सीमा) पर लौटता है, और उनका शुल्क कभी नहीं लिया जाता।
प्र: समाप्ति तिथि कितनी ताज़ा होती है?
उ: यह अनुरोध के समय सीधे रजिस्ट्री के अपने RDAP अभिलेख से आती है, बीच में कोई कैश परत नहीं होती, इसलिए यह उतनी ही ताज़ा है जितनी स्वयं रजिस्ट्री। यही बात इसे समाप्ति निगरानी के लिए उपयुक्त बनाती है — पोर्टफ़ोलियो की रोज़ जाँच करें और expires_at के आधार पर चेतावनी दें।