How is this different from classic WHOIS?

RDAP is the IETF's replacement for port-43 WHOIS. Where WHOIS returns free text that differs per registry and has to be scraped, RDAP returns structured JSON with a standard schema, over HTTPS, with proper 404s. We query the authoritative registry through the IANA bootstrap and flatten the jCard contact blocks into plain objects.

Why are registrant contacts usually missing?

Since GDPR, most gTLD registries redact registrant name, email, and address from public RDAP and publish only the sponsoring registrar plus an abuse contact. That redaction is the registry's answer, not a gap in this API — no WHOIS provider can show you data the registry does not publish.

Does it work for IP addresses and AS numbers?

Yes. Pass an IPv4 or IPv6 address to get the allocated network, its CIDR blocks, the holder, and the RIR handle; pass AS13335 or 13335 to get the AS name and its registrant, abuse, and technical contacts. The query type is detected from the input, so one parameter covers all three.

What does an unregistered domain return?

HTTP 200 with found: false. That is a real answer — it is how you check availability — so it costs the normal credit. Only an upstream failure (registry timeout, rate limit) returns a non-2xx, and those are never charged.

How current is the expiry date?

It comes straight from the registry's own RDAP record at request time, with no caching layer in between, so it is as current as the registry itself. That makes it suitable for expiry monitoring — poll a portfolio daily and alert on expires_at.

[ güvenlik · sicil ]● 2 kredi · dakikada 30 istek

WHOIS ve RDAP sorgusu API

Herhangi bir alan adı, IP adresi veya otonom sistem numarasının kayıt bilgileri, RDAP aracılığıyla doğrudan yetkili sicilden. Kayıt kuruluşu, ad sunucuları, DNSSEC, bitiş tarihleri ve kötüye kullanım iletişim bilgileri düz JSON olarak.

RDAP (kazınmış WHOIS değil)Alan adı · IP · ASNCanlı sicil verisi

auth · x-api-key

API Key

API key'iniz yok mu?

API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.

Oturum Aç API Key'leri Yönet

[ 02 · integrate ]

Entegrasyon rehberi

Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.

spec

GET/api/whois

base

https://www.apipick.com

Registration data for a domain, IP address, or AS number

parametreler

querystringzorunlu

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"

● 200 · yanıt

{
  "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
}

Gerçek Dünya Kullanım Senaryoları İçin Tasarlandı

⏰

Bitiş tarihi izleme

Alan adı portföyünüzü düzenli sorgulayın ve yenileme tarihlerinden önce uyarı üretin. Canlı sicil verisi olduğundan hiçbir şey önbellek döngüsü yüzünden eskimez.

🕵️

Alan adı durum tespiti

Bir muhatabın alan adına güvenmeden ya da bir tedarikçiyi onaylamadan önce kayıt yaşını, kayıt kuruluşunu ve durum kodlarını denetleyin.

🚨

Kötüye kullanım bildirimi

Bir IP veya ASN'yi sahibine ve kötüye kullanım iletişim adresine çözümleyin; böylece otomatik bildirimler gerçekten okunan bir posta kutusuna ulaşsın.

🤖

Ajanlar için veri zenginleştirme

Tek bir parametre alan adlarını, IP'leri ve ASN'leri kapsar; bu da bir dil modeli için tek ve anlaşılır bir araç tanımı demektir.

Yanıt alanları

Alan	Tür	Açıklama
type	string	Saptanan sorgu türü: domain, ip veya autnum
found	boolean	Nesne kayıtlı ya da tahsisli değilse false
registrar	string \| null	Yetkili kayıt kuruluşu (alan adları)
registered_at	string \| null	ISO 8601 biçiminde kayıt tarihi
expires_at	string \| null	ISO 8601 biçiminde bitiş tarihi (alan adları)
updated_at	string \| null	Kaydın son değiştiği ISO 8601 tarihi
status	string[]	EPP durum kodları, örn. client transfer prohibited
nameservers	string[]	Yetkilendirilmiş ad sunucuları (alan adları)
dnssec	boolean \| null	Yetkilendirmenin DNSSEC ile imzalanıp imzalanmadığı
cidr	string[]	Tahsisin CIDR blokları (IP sorguları)
asn	integer \| null	Otonom sistem numarası (ASN sorguları)
contacts[]	object[]	Roller, kurum, e-posta ve telefon içeren düzleştirilmiş jCard kayıtları
credits_used	integer	Bu istek için düşülen kredi
remaining_credits	integer	Hesabınızda kalan kredi

[ 03 · limits ]

Rate limit'ler

Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.

istek hızı

30req/min

API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.

eşzamanlılık

3concurrent

API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.

yanıt başlıkları

X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısı

X-RateLimit-RemainingMevcut penceredeki kalan istek sayısı

X-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniye

Retry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)

● 429 · çok fazla istek

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
}

Veri kaynağı ve lisans

Kayıtlar her nesnenin yetkili sicilinden gelir — alan adları için Verisign, Nominet ve diğer sicil işletmecileri; IP aralıkları ile otonom sistem numaraları için ARIN, RIPE NCC, APNIC, LACNIC ve AFRINIC — IANA'nın RDAP bootstrap mekanizmasıyla çözümlenir. Hiçbir şey önbelleğe alınmaz veya yeniden yayımlanmaz: sicilin istek anında verdiğini görürsünüz.

Sıkça Sorulan Sorular

S: Klasik WHOIS'ten farkı nedir?

C: RDAP, IETF'in 43 numaralı bağlantı noktasındaki WHOIS için geliştirdiği halefidir. WHOIS sicilden sicile değişen ve kazınması gereken serbest metin döndürürken RDAP, HTTPS üzerinden standart şemalı yapılandırılmış JSON ve düzgün 404 yanıtları döndürür. Biz yetkili sicili IANA bootstrap ile sorgular ve jCard iletişim bloklarını sade nesnelere düzleştiririz.

S: Kayıt sahibinin iletişim bilgileri neden çoğunlukla boş?

C: GDPR'den bu yana çoğu gTLD sicili, kamuya açık RDAP'ta kayıt sahibinin adını, e-postasını ve adresini gizler ve yalnızca yetkili kayıt kuruluşu ile bir kötüye kullanım iletişim adresini yayımlar. Bu gizleme sicilin verdiği yanıttır, bu API'nin eksiği değil — hiçbir WHOIS sağlayıcısı sicilin yayımlamadığı veriyi gösteremez.

S: IP adresleri ve otonom sistem numaraları için de çalışıyor mu?

C: Evet. Tahsis edilmiş ağı, CIDR bloklarını, sahibini ve RIR tanımlayıcısını almak için IPv4 veya IPv6 adresi verin; AS adını ve sahip, kötüye kullanım ile teknik iletişim bilgilerini almak için AS13335 ya da 13335 verin. Sorgu türü girdiden saptanır, dolayısıyla tek parametre üç durumu da kapsar.

S: Kayıtlı olmayan bir alan adı ne döndürür?

C: found: false ile birlikte HTTP 200. Bu gerçek bir yanıttır — müsaitlik tam da böyle denetlenir — ve bu nedenle olağan krediyi harcar. 2xx dışında bir kod yalnızca üst kaynaktaki bir arıza (sicil zaman aşımı, hız sınırı) durumunda döner ve bu durumlar asla ücretlendirilmez.

S: Bitiş tarihi ne kadar günceldir?

C: İstek anında doğrudan sicilin kendi RDAP kaydından gelir, arada hiçbir önbellek katmanı yoktur; yani sicilin kendisi kadar günceldir. Bu da onu bitiş tarihi izlemeye uygun kılar — portföyü her gün sorgulayın ve expires_at üzerinden uyarı üretin.