---
title: "Expired Domain API: Hızlı Başlangıç ve Uç Listesi"
description: "Elenmiş expired domainler için REST API. Filtreli canlı liste, tam rapor, istek üzerine domain kontrolü, alarm kuralları ve RDAP, DNS, Domain Rating sorgul…"
url: https://hunter.domains/tr/docs/api
language: tr
---

# Expired domain API

Sitedeki listeler ve raporlar, JSON olarak. Günlük avı filtrele, bir domainin tam raporunu oku, herhangi bir domain için rapor iste ve alarm kurallarını kendi kodundan yönet.

## Hızlı başlangıç

Temel adres `https://hunter.domains/api/v1`. [Hesabındaki API sayfasında](https://hunter.domains/tr/account/api) bir anahtar oluştur ve her istekte gönder:

```
curl "https://hunter.domains/api/v1/domains?min_dr=30&tld=com,org" \
  -H "Authorization: Bearer hd_…"
```

```
{
    "data": [
        {
            "domain": "example.org",
            "tld": "org",
            "status": "listed",
            "score": 78,
            "verdict": "ok",
            "flags": [],
            "topic": "Home",
            "language": "en",
            "title": "Seasonal planting guides for small gardens",
            "metrics": {
                "domain_rating": 46,
                "referring_domains": 412,
                "archive_years": 17,
                "archive_first_year": 2006,
                "archive_last_year": 2025,
                "trust_flow": 28,
                "citation_flow": 31
            },
            "listing": {
                "source": "godaddy",
                "type": "bid",
                "price_usd": 25,
                "bids": 3,
                "ends_at": "2026-10-09T17:30:00Z",
                "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org"
            },
            "found_at": "2026-10-06T16:42:10Z",
            "open": true,
            "detail": "full",
            "report_url": "https://hunter.domains/domain/example.org"
        }
    ],
    "meta": {
        "list": "live",
        "total": 5,
        "page": 1,
        "per_page": 25,
        "pages": 1,
        "plan": "free",
        "locked": 57,
        "locked_note": "57 more matching domains are on the Pro list.",
        "upgrade_url": "https://hunter.domains/pricing"
    }
}
```

İşin çoğunu şu üç çağrı görür:

```
# Listedeki bir domainin tam raporu
curl "https://hunter.domains/api/v1/domains/example.org" -H "Authorization: Bearer hd_…"

# Düşmüş ve hâlâ alınmamış olanlar (Pro)
curl "https://hunter.domains/api/v1/domains/available" -H "Authorization: Bearer hd_…"

# Listede olsun olmasın herhangi bir domain için rapor
curl -X POST "https://hunter.domains/api/v1/checks" -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" -d '{"domain": "example.org"}'
```

Bütün uçların makinece okunabilir tarifi [`/api/v1/openapi.json`](https://hunter.domains/api/v1/openapi.json) adresinde (OpenAPI 3.1).

## Kimlik doğrulama

Her istek, `Authorization` başlığında bir API anahtarı taşır:

```
Authorization: Bearer hd_…
```

- Anahtarlar [hesabındaki API sayfasında](https://hunter.domains/tr/account/api) oluşturulur ve silinir. En çok 5 anahtarın olabilir; her entegrasyona ayrı anahtar ver ki birini iptal ettiğinde diğerleri bozulmasın.
- Anahtar yalnızca oluşturulduğu anda gösterilir. Biz yalnızca özetini saklarız; kaybolan anahtar geri getirilemez, silip yenisini oluşturursun.
- Anahtar hesabın gibi davranır: planının gördüğünü görür; alarm kurallarını, takip listeni ve webhook adreslerini değiştirebilir. Sunucu tarafında tut. Web sayfasına, mobil uygulamaya ya da herkese açık bir depoya koyma.
- Hesabın e-posta adresi doğrulanmış olmalı.
- Bütün istekler HTTPS üzerinden gider.

## Planlar ve sınırlar

Ayrı bir API planı yok. Anahtar, hesabının sitede gördüğünü döndürür.

|  | Ücretsiz | Pro |
| --- | --- | --- |
| İstek | Dakikada 30, günde 1,000 | Dakikada 120, günde 20,000 |
| Canlı liste | Günün 5 açık domaini | Bütün domainler |
| Şu an boşta | Yalnızca açık domainler | Bütün domainler |
| Ayrıntılı rapor ve canlandırma kiti | Açık domainlerde | Bütün domainlerde |
| Alarm kuralı ve webhook | — | Var |
| Sorgular (RDAP, DNS, DR) | Saatte 200 domain | Saatte 600 domain |

Sınırlar hesap başınadır: bütün anahtarların ve MCP bağlantıların aynı sayacı kullanır. Her cevap, içinde bulunulan dakika için `X-RateLimit-Limit` ve `X-RateLimit-Remaining` başlıklarını taşır. Sınırı aşarsan API `429` döner; `Retry-After` başlığı kaç saniye beklemen gerektiğini söyler. Sorguların domain sayısıyla ölçülen ayrı bir saatlik kotası vardır; bu kotayı sitedeki ücretsiz araçlarla paylaşırlar.

Ücretsiz planda liste cevabı yalnızca adını görebildiğin domainleri içerir. `meta.locked`, filtrene uyan kaç domainin daha Pro listesinde olduğunu söyler; `q` ile arama yaptığında bu alan verilmez.

## İstek ve cevap

- **JSON gider, JSON gelir.** `POST` ve `PATCH` isteklerinde gövdeyle birlikte `Content-Type: application/json` gönder.
- **Tek zarf.** Başarılı cevap `{"data": …}` biçimindedir; listeler `total`, `page`, `per_page` ve `pages` alanlarını taşıyan `{"meta": …}` ekler.
- **Sayfalama.** `page` 1'den başlar. `per_page` varsayılan olarak 25, en çok 100 olur.
- **Sorgu dizgesindeki listeler** virgülle ayrılır: `tld=com,org`.
- **Zamanlar** UTC ve ISO 8601 biçimindedir: `2026-10-09T17:30:00Z`. Fiyatlar ABD doları cinsindendir.
- **Olmayan değer `null` döner**, sıfır değil. Henüz fiyatı olmayan (silinmeyi bekleyen) domainde `price_usd: null` gelir.
- **Yeni alanlar eklenebilir.** Tanımadığın alanları yok say.

## Domain nesnesi

Listeler bu özeti döndürür. Rapor ucu aynı nesneyi daha fazla alanla verir.

```
{
    "domain": "example.org",
    "tld": "org",
    "status": "listed",
    "score": 78,
    "verdict": "ok",
    "flags": [],
    "topic": "Home",
    "language": "en",
    "title": "Seasonal planting guides for small gardens",
    "metrics": {
        "domain_rating": 46,
        "referring_domains": 412,
        "archive_years": 17,
        "archive_first_year": 2006,
        "archive_last_year": 2025,
        "trust_flow": 28,
        "citation_flow": 31
    },
    "listing": {
        "source": "godaddy",
        "type": "bid",
        "price_usd": 25,
        "bids": 3,
        "ends_at": "2026-10-09T17:30:00Z",
        "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org"
    },
    "found_at": "2026-10-06T16:42:10Z",
    "open": true,
    "detail": "full",
    "report_url": "https://hunter.domains/domain/example.org"
}
```

| Alan | Anlamı |
| --- | --- |
| `status` | `listed`, `ending_soon` (24 saatten az kaldı), `pending_delete`, `available` (düşmüş ve alınmamış) ya da `ended`. |
| `score` | Hunter puanı, 0–100. 45'in altındaki domainler listeye girmez. |
| `verdict` | `ok`, ya da geçmiş incelemesinde ikinci kez bakmaya değer bir şey bulunduysa `risky`. |
| `flags` | Risk bayrakları; gizlenmez, gösterilir: `dr_inflated`, `parked`, `topic_change`, `lang_change`, `gap`, `trademark`, `not_indexed`, `anchor_foreign`. Boş liste bayrak yok demektir. |
| `topic` | Niş: backlink profilinin en güçlü Majestic üst konu kategorisi, ör. `Health` ya da `Business`. |
| `language`, `title` | Eski sitenin arşivden okunan dili ve başlığı. |
| `metrics` | `domain_rating` (Ahrefs), `referring_domains`, arşiv aralığı; ayrıntı açıksa `trust_flow` ve `citation_flow` (Majestic). |
| `listing` | Nerede listelendiği: `source` (`godaddy`, `dropcatch`, `snapnames`, `sedo`, `dynadot`, `parkio`, `iis`), `type` (`bid`, `buy_now`, `auction`, `pending_delete`), güncel `price_usd`, `bids`, `ends_at` ve ilanın `url` adresi. Boştaki domainde `url` bir kayıt firmasına gider. |
| `found_at` | Domainin listeye girdiği an. |
| `open` | Ücretsiz planda günün açık domainlerinden biriyse `true`. |
| `detail` | Cevap Trust Flow'u ve ayrıntılı raporu içeriyorsa `full`, içermiyorsa `basic`. |
| `report_url` | Sitedeki rapor sayfası. |

## Hatalar

Hatalar HTTP durum koduyla ve tek bir biçimle döner:

```
{
    "error": {
        "code": "plan_required",
        "message": "This domain is on the Pro list.",
        "upgrade_url": "https://hunter.domains/pricing",
        "docs": "https://hunter.domains/docs/api#errors"
    }
}
```

`code` sabittir ve programın içindir. `message` insanlar içindir, İngilizcedir ve değişebilir.

| HTTP | `code` | Anlamı |
| --- | --- | --- |
| 401 | `unauthenticated` | Anahtar yok, yanlış yazılmış ya da iptal edilmiş. |
| 402 | `no_checks_left` | Domain kontrol hakkı kalmadı. |
| 403 | `email_unverified` | Hesabın e-posta adresi henüz doğrulanmamış. |
| 403 | `plan_required` | Domain ya da özellik Pro’ya dahil. Cevapta `upgrade_url` bulunur. |
| 404 | `not_found` | Böyle bir kayıt yok ya da domain listede değil. |
| 405 | `method_not_allowed` | Uç bu HTTP yöntemini kabul etmiyor. |
| 409 | `limit_reached` | Planın alarm kuralı, takip ya da webhook ucu sınırı doldu. |
| 422 | `validation_failed` | Bir parametre eksik ya da geçersiz. `fields`, mesajları alan alan verir. |
| 429 | `rate_limited` | Çok fazla istek. `Retry-After` başlığındaki saniye kadar bekle. |
| 429 | `lookup_quota_exceeded` | Kayıt kurumu, DNS ve DR sorgularının saatlik kotası doldu. |
| 500 | `server_error` | Hata bizde. Yeniden denemek güvenlidir. |

`429` ya da `5xx` ile başarısız olan istek, kısa bir beklemeden sonra güvenle yeniden denenebilir. `4xx` hatalarını isteği değiştirmeden yeniden deneme.

## Hesap ve istatistik

Anahtarının neler yapabildiğini ve günlük taramadan listeye ne kadarının girdiğini gösterir.

### Planın, sınırların ve kullanımın

GET `/me`

```
curl "https://hunter.domains/api/v1/me" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "email": "you@example.com", "plan": "pro", "plan_renews_at": "2026-11-06T09:12:00Z", "limits": { "requests_per_minute": 120, "requests_per_day": 20000, "requests_today": 214, "lookup_domains_per_hour": 600 }, "checks": { "available": 27, "from_plan_this_month": 27, "welcome": 0, "purchased": 0 }, "alerts": { "used": 2, "limit": 10 }, "watchlist": { "used": 6, "limit": null }, "webhooks": { "used": 1, "limit": 3 } } }`

### Son tarama ve liste boyutları

GET `/stats`

```
curl "https://hunter.domains/api/v1/stats" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "last_scan": { "started_at": "2026-10-06T15:30:02Z", "finished_at": "2026-10-06T17:48:40Z", "scanned": 2656148, "passed_authority_filter": 426 }, "live": { "domains": 62, "open_on_free_plan": 5, "ending_within_24h": 14, "average_score": 64.2, "average_domain_rating": 36.1 }, "available_now": 9, "archive": 310 } }`

## Domainler

Üç liste aynı biçimde döner: canlı liste (bitmemiş artırmalar ve düşmeyi bekleyenler), Şu an boşta (düşmüş, kimse almamış; kayıt kurumunda iki saatte bir yeniden sorgulanır) ve arşiv (biten her şey).

### Liste filtreleri

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `q` | string | Domain adında ve eski site başlığında arama (en çok 60 karakter). |
| `min_score` | integer | En düşük Hunter puanı, 0–100. |
| `min_dr` | integer | En düşük Ahrefs Domain Rating, 0–100. |
| `min_tf` | integer | En düşük Majestic Trust Flow, 0–100. |
| `min_ref_domains` | integer | En az yönlendiren domain sayısı. |
| `min_archive_years` | integer | Wayback’te kaydı olan en az farklı yıl sayısı, 0–30. |
| `max_price` | integer | En yüksek güncel fiyat (USD). Fiyatı olmayan (silinmeyi bekleyen) domainler her zaman geçer. |
| `tld` | string | Uzantılar, virgülle ayrılmış. |
| `type` | string | Artırma türleri, virgülle ayrılmış. Değerler: `bid`, `buy_now`, `pending_delete`, `auction`. |
| `topic` | string | Nişler (Majestic’in üst konu kategorisi), virgülle ayrılmış. Değerler: `Arts`, `Business`, `Computers`, `Games`, `Health`, `Home`, `News`, `Recreation`, `Reference`, `Regional`, `Science`, `Shopping`, `Society`, `Sports`. |
| `lang` | string | Eski sitenin dili, iki harfli kodlarla, virgülle ayrılmış. |
| `clean` | boolean | Yalnızca kararı `ok` olan ve risk bayrağı taşımayan domainler. |
| `since` | string | Yalnızca bu andan sonra bulunan domainler (ISO 8601). Son çağrından beri yeni gelenleri almak için kullan. |
| `ending_within_hours` | integer | Yalnızca bu kadar saat içinde biten artırmalar, 1–720. |
| `sort` | string | Varsayılan `score` (arşivde `ended`). Değerler: `score`, `dr`, `ending`, `newest`, `price`, `ended`. |
| `page` | integer | Sayfa numarası, 1’den başlar. |
| `per_page` | integer | Sayfa başına kayıt: 1–100, varsayılan 25. |

### Canlı liste

GET `/domains`

Artırması ya da düşmesi henüz bitmemiş domainler, en yüksek puan üstte. Ücretsiz planda cevap günün açık domainlerini içerir; `meta.locked` aynı filtreye uyan kaç domainin Pro’da olduğunu söyler.

Parametreler: Liste filtreleri.

```
curl "https://hunter.domains/api/v1/domains?min_dr=30&tld=com,org" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "tld": "org", "status": "listed", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } ], "meta": { "list": "live", "total": 5, "page": 1, "per_page": 25, "pages": 1, "plan": "free", "locked": 57, "locked_note": "57 more matching domains are on the Pro list.", "upgrade_url": "https://hunter.domains/pricing" } }`

### Şu an boşta

GET `/domains/available`

Listeye girmiş, boşa düşmüş ve kimsenin almadığı domainler. Artırma yok: fiyatı normal kayıt ücretidir. Pro listesidir; ücretsiz plan burada yalnızca kendi açık domainlerinden düşeni görür.

Parametreler: Liste filtreleri.

```
curl "https://hunter.domains/api/v1/domains/available" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "tld": "org", "status": "available", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "dropcatch", "type": "pending_delete", "price_usd": null, "bids": 0, "ends_at": "2026-10-04T18:00:00Z", "url": "https://www.spaceship.com/domain-search/?query=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } ], "meta": { "list": "available", "total": 5, "page": 1, "per_page": 25, "pages": 1, "plan": "free", "locked": 57, "locked_note": "57 more matching domains are on the Pro list.", "upgrade_url": "https://hunter.domains/pricing" } }`

### Arşiv

GET `/domains/archive`

Artırması ya da düşmesi bitmiş bütün domainler, en yeni üstte. Her plana açıktır.

Parametreler: Liste filtreleri.

```
curl "https://hunter.domains/api/v1/domains/archive" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "tld": "org", "status": "ended", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } ], "meta": { "list": "archive", "total": 5, "page": 1, "per_page": 25, "pages": 1, "plan": "free", "locked": 57, "locked_note": "57 more matching domains are on the Pro list.", "upgrade_url": "https://hunter.domains/pricing" } }`

### Listedeki bir domainin tam raporu

GET `/domains/{domain}`

Rapor sayfasındaki her şey: metrikler, puan dökümü, en güçlü yönlendiren domainler, çapa metinleri, konu güveni, risk kontrolleri ve artırma bittiyse kayıt durumu. `detail`, günün açık domainlerinde ve Pro’da her domainde `full`, diğerlerinde `basic` döner. Listede olmayan domain için `404` döner; onlar için domain kontrolünü kullan.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domain` yol · zorunlu | string | Domain adı. |

```
curl "https://hunter.domains/api/v1/domains/example.org" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "domain": "example.org", "tld": "org", "status": "listed", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31, "tf_cf_ratio": 0.9, "backlinks": 9840, "semrush_authority_score": 21, "moz_domain_authority": 33, "open_pagerank": 4.1, "google_indexed_pages": 10, "archived_urls": 1260 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org", "score_breakdown": { "ahrefs_dr": 0.92, "trust_flow": 0.7, "ref_domains": 0.87, "semrush_as": 0.7, "open_pagerank": 0.41, "history": 1, "age": 1, "price": 0.8, "penalty": 0 }, "top_referring_domains": [ "rhs.org.uk", "gardenersworld.com", "extension.umn.edu" ], "anchors": { "top": [ { "text": "seasonal planting guide", "referring_domains": 38 }, { "text": "example.org", "referring_domains": 27 } ], "spam_share": 0 }, "topical_trust_flow": [ { "topic": "Home/Gardening", "trust_flow": 27 }, { "topic": "Recreation/Outdoors", "trust_flow": 14 } ], "risk_checks": [ { "flag": "dr_inflated", "label": "Inflated DR", "result": "clean", "severity": "risk", "note": "DR is in line with the number of referring domains" }, { "flag": "topic_change", "label": "Topic changed", "result": "clean", "severity": "info", "note": "Site topic is the same throughout the archive" } ], "wayback_url": "https://web.archive.org/web/*/example.org", "registration": null, "rank_on_hunt_day": 4, "revival_kit": { "pages": 38, "url": "https://hunter.domains/api/v1/domains/example.org/pages" } } }`

### Canlandırma kiti: eski URL’ler ve arşiv metni

GET `/domains/{domain}/pages`

Eski sitenin en çok arşivlenen sayfaları, kayıt sayıları ve Wayback linkleriyle. Bu yolları yeniden kurarsan (ya da 301 ile yönlendirirsen) eski backlinkler çalışmaya devam eder. `include=content` eklersen her sayfanın arşivlenmiş metni Markdown olarak gelir.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domain` yol · zorunlu | string | Domain adı. |
| `include` sorgu | string | Arşiv metnini de almak için `content` gönder (sayfa küçülür: varsayılan 10, en çok 20). Değerler: `content`. |
| `page` sorgu | integer | Sayfa numarası, 1’den başlar. |
| `per_page` sorgu | integer | Sayfa başına kayıt: 1–100, varsayılan 50. |

```
curl "https://hunter.domains/api/v1/domains/example.org/pages" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "path": "/guides/spring-planting", "url": "http://example.org/guides/spring-planting", "captures": 64, "last_capture": "2025-03-18", "title": "Spring planting calendar", "words": 1180, "wayback_url": "https://web.archive.org/web/20250318101500/http://example.org/guides/spring-planting", "has_content": true } ], "meta": { "domain": "example.org", "total": 38, "page": 1, "per_page": 50, "pages": 1 } }`

## Takip listesi

Takip ettiğin domainler. Pro’da takipteki domain için artırma bitmeden hatırlatma, boşa düşerse haber gelir.

### Takip ettiğin domainler

GET `/watchlist`

```
curl "https://hunter.domains/api/v1/watchlist" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "tld": "org", "status": "listed", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } ] }`

### Domaini takibe al

PUT `/watchlist/{domain}`

Tekrarlanabilir. Ücretsiz planda en çok 3 domain takip edilir.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domain` yol · zorunlu | string | Domain adı. |

```
curl -X PUT "https://hunter.domains/api/v1/watchlist/example.org" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "domain": "example.org", "tld": "org", "status": "listed", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } }`

### Domaini takipten çıkar

DELETE `/watchlist/{domain}`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domain` yol · zorunlu | string | Domain adı. |

```
curl -X DELETE "https://hunter.domains/api/v1/watchlist/example.org" \
  -H "Authorization: Bearer hd_…"
```

204 · Gövde dönmez.

## Alarm kuralları

Kural, istediğin domaini tarif eder. Listeye giren her yeni domain kurallarınla karşılaştırılır; eşleşme e-posta ve `alert.matched` webhook’u olarak gelir.

### Alarm kuralların

GET `/alerts`

```
curl "https://hunter.domains/api/v1/alerts" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "id": 12, "name": "Health, DR 30+", "active": true, "frequency": "instant", "min_score": 60, "min_dr": 30, "min_tf": null, "min_ref_domains": null, "min_archive_years": 5, "max_price": 150, "tlds": [ "com", "org" ], "listing_types": [], "topics": [ "Health" ], "langs": [ "en" ], "clean_only": true, "keywords": [], "match_count": 7, "last_matched_at": "2026-10-05T16:51:30Z", "created_at": "2026-10-03T10:20:00Z" } ] }`

### Alarm kuralı oluştur Pro

POST `/alerts`

En çok 10 kural. Bir alanı göndermezsen (ya da 0 gönderirsen) “sınır yok” demektir.

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `name` gövde · zorunlu | string | Kuralın adı, en çok 80 karakter. |
| `frequency` gövde | string | `instant` her eşleşmeyi bulunduğu an e-postayla yollar; `daily` günlük özete bırakır. Varsayılan `instant`. Webhook her durumda anında gider. Değerler: `instant`, `daily`. |
| `min_score` gövde | integer | En düşük Hunter puanı, 0–100. |
| `min_dr` gövde | integer | En düşük Domain Rating, 0–100. |
| `min_tf` gövde | integer | En düşük Trust Flow, 0–100. |
| `min_ref_domains` gövde | integer | En az yönlendiren domain. |
| `min_archive_years` gövde | integer | Arşivde en az yıl, 0–30. |
| `max_price` gövde | integer | En yüksek fiyat (USD). |
| `tlds` gövde | string[] | Uzantılar. |
| `listing_types` gövde | string[] | Artırma türleri. Değerler: `bid`, `buy_now`, `pending_delete`, `auction`. |
| `topics` gövde | string[] | Nişler. Değerler: `Arts`, `Business`, `Computers`, `Games`, `Health`, `Home`, `News`, `Recreation`, `Reference`, `Regional`, `Science`, `Shopping`, `Society`, `Sports`. |
| `langs` gövde | string[] | Eski sitenin dilleri. Değerler: `en`, `de`, `fr`, `es`, `it`, `nl`, `pt`, `tr`, `ru`, `sv`, `ja`. |
| `clean_only` gövde | boolean | Yalnızca risk bayrağı olmayan domainler. |
| `keywords` gövde | string[] | Yalnızca adında ya da eski başlığında bu kelimelerden biri geçenler. |
| `active` gövde | boolean | Kural açık mı. Varsayılan `true`. |

```
curl -X POST "https://hunter.domains/api/v1/alerts" \
  -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Health, DR 30+","min_score":60,"min_dr":30,"max_price":150,"tlds":["com","org"],"topics":["Health"],"clean_only":true}'
```

**Cevap · 201**

`{ "data": { "id": 12, "name": "Health, DR 30+", "active": true, "frequency": "instant", "min_score": 60, "min_dr": 30, "min_tf": null, "min_ref_domains": null, "min_archive_years": 5, "max_price": 150, "tlds": [ "com", "org" ], "listing_types": [], "topics": [ "Health" ], "langs": [ "en" ], "clean_only": true, "keywords": [], "match_count": 7, "last_matched_at": "2026-10-05T16:51:30Z", "created_at": "2026-10-03T10:20:00Z" } }`

### Tek bir alarm kuralı

GET `/alerts/{id}`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Kuralın kimliği. |

```
curl "https://hunter.domains/api/v1/alerts/12" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "id": 12, "name": "Health, DR 30+", "active": true, "frequency": "instant", "min_score": 60, "min_dr": 30, "min_tf": null, "min_ref_domains": null, "min_archive_years": 5, "max_price": 150, "tlds": [ "com", "org" ], "listing_types": [], "topics": [ "Health" ], "langs": [ "en" ], "clean_only": true, "keywords": [], "match_count": 7, "last_matched_at": "2026-10-05T16:51:30Z", "created_at": "2026-10-03T10:20:00Z" } }`

### Alarm kuralını değiştir

PATCH `/alerts/{id}`

Yalnızca değiştirmek istediğin alanları gönder. `{"active": false}` kuralı duraklatır.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Kuralın kimliği. |
| `name` gövde | string | Kuralın adı, en çok 80 karakter. |
| `frequency` gövde | string | `instant` her eşleşmeyi bulunduğu an e-postayla yollar; `daily` günlük özete bırakır. Varsayılan `instant`. Webhook her durumda anında gider. Değerler: `instant`, `daily`. |
| `min_score` gövde | integer | En düşük Hunter puanı, 0–100. |
| `min_dr` gövde | integer | En düşük Domain Rating, 0–100. |
| `min_tf` gövde | integer | En düşük Trust Flow, 0–100. |
| `min_ref_domains` gövde | integer | En az yönlendiren domain. |
| `min_archive_years` gövde | integer | Arşivde en az yıl, 0–30. |
| `max_price` gövde | integer | En yüksek fiyat (USD). |
| `tlds` gövde | string[] | Uzantılar. |
| `listing_types` gövde | string[] | Artırma türleri. Değerler: `bid`, `buy_now`, `pending_delete`, `auction`. |
| `topics` gövde | string[] | Nişler. Değerler: `Arts`, `Business`, `Computers`, `Games`, `Health`, `Home`, `News`, `Recreation`, `Reference`, `Regional`, `Science`, `Shopping`, `Society`, `Sports`. |
| `langs` gövde | string[] | Eski sitenin dilleri. Değerler: `en`, `de`, `fr`, `es`, `it`, `nl`, `pt`, `tr`, `ru`, `sv`, `ja`. |
| `clean_only` gövde | boolean | Yalnızca risk bayrağı olmayan domainler. |
| `keywords` gövde | string[] | Yalnızca adında ya da eski başlığında bu kelimelerden biri geçenler. |
| `active` gövde | boolean | Kural açık mı. Varsayılan `true`. |

```
curl -X PATCH "https://hunter.domains/api/v1/alerts/12" \
  -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Health, DR 30+","min_score":60,"min_dr":30,"max_price":150,"tlds":["com","org"],"topics":["Health"],"clean_only":true}'
```

**Cevap · 200**

`{ "data": { "id": 12, "name": "Health, DR 30+", "active": true, "frequency": "instant", "min_score": 60, "min_dr": 30, "min_tf": null, "min_ref_domains": null, "min_archive_years": 5, "max_price": 150, "tlds": [ "com", "org" ], "listing_types": [], "topics": [ "Health" ], "langs": [ "en" ], "clean_only": true, "keywords": [], "match_count": 7, "last_matched_at": "2026-10-05T16:51:30Z", "created_at": "2026-10-03T10:20:00Z" } }`

### Alarm kuralını sil

DELETE `/alerts/{id}`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Kuralın kimliği. |

```
curl -X DELETE "https://hunter.domains/api/v1/alerts/12" \
  -H "Authorization: Bearer hd_…"
```

204 · Gövde dönmez.

### Kurallarına uyan domainler

GET `/alerts/matches`

En yeni eşleşme üstte. Webhook alamıyorsan `since` ile aralıklı sorgula.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `since` sorgu | string | Yalnızca bu andan sonraki eşleşmeler (ISO 8601). |
| `limit` sorgu | integer | Kaç kayıt dönsün: 1–100, varsayılan 50. |

```
curl "https://hunter.domains/api/v1/alerts/matches" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "matched_at": "2026-10-06T16:44:02Z", "alert": { "id": 12, "name": "Health, DR 30+" }, "domain": { "domain": "example.org", "tld": "org", "status": "listed", "score": 78, "verdict": "ok", "flags": [], "topic": "Home", "language": "en", "title": "Seasonal planting guides for small gardens", "metrics": { "domain_rating": 46, "referring_domains": 412, "archive_years": 17, "archive_first_year": 2006, "archive_last_year": 2025, "trust_flow": 28, "citation_flow": 31 }, "listing": { "source": "godaddy", "type": "bid", "price_usd": 25, "bids": 3, "ends_at": "2026-10-09T17:30:00Z", "url": "https://auctions.godaddy.com/trpItemListing.aspx?domain=example.org" }, "found_at": "2026-10-06T16:42:10Z", "open": true, "detail": "full", "report_url": "https://hunter.domains/domain/example.org" } } ] }`

## Domain kontrolü

Listede olsun olmasın herhangi bir domain için tam rapor ister. Kontrol Wayback geçmişini okuduğu için kuyrukta çalışır ve genellikle iki dakika içinde biter. Her yeni kontrol bir hak harcar; aynı domain 7 gün içinde yeniden istenirse eldeki rapor ücretsiz döner.

### Herhangi bir domain için rapor iste

POST `/checks`

Kuyruğa giren kontrolle `202`, bu domain son 7 günde kontrol edildiyse eldeki kontrolle `200` döner. `GET /checks/{id}` ucunu birkaç saniyede bir sorgula ya da `check.completed` webhook’una abone ol. Hak kalmadıysa `402` döner.

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `domain` gövde · zorunlu | string | Kontrol edilecek domain. URL ya da alt alan adı yazılırsa kayıtlı domaine indirgenir. |

```
curl -X POST "https://hunter.domains/api/v1/checks" \
  -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.org"}'
```

**Cevap · 202**

`{ "data": { "id": "01k6x2f0q8m3r7t9v4b5n6c8dz", "domain": "example.org", "status": "queued", "created_at": "2026-10-06T17:02:11Z", "finished_at": null, "score": null, "verdict": null, "report_url": "https://hunter.domains/domain-checker/report/01k6x2f0q8m3r7t9v4b5n6c8dz", "queue_position": 1 } }`

### Kontrollerin

GET `/checks`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `page` sorgu | integer | Sayfa numarası, 1’den başlar. |
| `per_page` sorgu | integer | Sayfa başına kayıt: 1–50, varsayılan 25. |

```
curl "https://hunter.domains/api/v1/checks" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "id": "01k6x2f0q8m3r7t9v4b5n6c8dz", "domain": "example.org", "status": "done", "created_at": "2026-10-06T17:02:11Z", "finished_at": "2026-10-06T17:03:24Z", "score": 78, "verdict": "ok", "report_url": "https://hunter.domains/domain-checker/report/01k6x2f0q8m3r7t9v4b5n6c8dz" } ], "meta": { "total": 4, "page": 1, "per_page": 25, "pages": 1 } }`

### Bir kontrol ve bittiyse raporu

GET `/checks/{id}`

`status`; `queued`, `running`, `done` ya da `failed` olur. Başarısız kontrol hak harcamaz. `would_list`, aynı domainin günlük elememizden geçip geçmeyeceğini söyler; geçmezse sebebi `reject_reasons` içindedir.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | string | Kontrolün kimliği. |

```
curl "https://hunter.domains/api/v1/checks/01k6x2f0q8m3r7t9v4b5n6c8dz" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "id": "01k6x2f0q8m3r7t9v4b5n6c8dz", "domain": "example.org", "status": "done", "created_at": "2026-10-06T17:02:11Z", "finished_at": "2026-10-06T17:03:24Z", "score": 78, "verdict": "ok", "report_url": "https://hunter.domains/domain-checker/report/01k6x2f0q8m3r7t9v4b5n6c8dz", "would_list": true, "reject_reasons": [], "report": { "…": "same shape as GET /domains/{domain}" }, "registration": { "state": "registered", "registrar": "Example Registrar, LLC", "registered_at": "2006-04-11T09:00:00Z", "expires_at": "2027-04-11T09:00:00Z", "statuses": [ "client transfer prohibited" ] } } }`

## Sorgular

Kayıt kurumu (RDAP), DNS ve Domain Rating sorguları, canlı. Kontrol hakkı harcamaz; sitedeki ücretsiz araçlarla aynı saatlik kotayı kullanır.

### Kayıt bilgisi ve düşme tahmini

GET `/tools/whois`

Kayıt kurumundan RDAP ile canlı okunur: durum, kayıt firması, tarihler, durum kodları, ad sunucuları ve genel uzantılarda domainin düşeceği tarih aralığı.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domain` sorgu · zorunlu | string | Domain adı. |

```
curl "https://hunter.domains/api/v1/tools/whois?domain=example.org" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "domain": "example.org", "state": "registered", "registrar": "Example Registrar, LLC", "registrar_iana_id": "146", "registered_at": "2006-04-11T09:00:00Z", "expires_at": "2027-04-11T09:00:00Z", "updated_at": "2026-03-02T08:14:00Z", "statuses": [ "client transfer prohibited" ], "nameservers": [ "ns1.example.net", "ns2.example.net" ], "dnssec": false, "drop_estimate": { "stage": "active", "earliest": "2027-05-16", "latest": "2027-06-30", "exact": false, "drop_hour_utc": null } } }`

### Toplu müsaitlik sorgusu

GET `/tools/availability`

`state`; `available`, `registered`, `dropping` (kurtarma ya da silinme bekleme döneminde) ya da `unknown` (kayıt kurumu RDAP sunmuyor ya da cevap vermedi) olur. Tek istekte ücretsiz planda en çok 20, Pro’da 50 domain.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domains` sorgu · zorunlu | string | Virgülle ayrılmış domain adları. |

```
curl "https://hunter.domains/api/v1/tools/availability?domains=example.org,example.com" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "state": "registered", "registrar": "Example Registrar, LLC", "registrar_iana_id": "146", "registered_at": "2006-04-11T09:00:00Z", "expires_at": "2027-04-11T09:00:00Z", "updated_at": "2026-03-02T08:14:00Z", "statuses": [ "client transfer prohibited" ], "nameservers": [ "ns1.example.net", "ns2.example.net" ], "dnssec": false } ] }`

### Ahrefs Domain Rating

GET `/tools/domain-rating`

Tek istekte ücretsiz planda en çok 10, Pro’da 25 domain. Sonuçlar 7 gün önbellekte kalır. Kaynağın sınırı dolduğunda satır `error: "busy_retry_later"` taşıyabilir.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `domains` sorgu · zorunlu | string | Virgülle ayrılmış domain adları. |

```
curl "https://hunter.domains/api/v1/tools/domain-rating?domains=example.org,example.com" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "domain": "example.org", "domain_rating": 46, "error": null } ] }`

### DNS kayıtları

GET `/tools/dns`

A, AAAA, CNAME, MX, NS, TXT, SOA ve CAA kayıtları; ayrıca e-posta, SPF, DMARC ve park işaretleri.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `host` sorgu · zorunlu | string | Domain ya da alt alan adı. |

```
curl "https://hunter.domains/api/v1/tools/dns?host=example.org" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "host": "example.org", "records": { "A": [ { "value": "93.184.215.14", "ttl": 300, "extra": null } ], "MX": [ { "value": "mail.example.org", "ttl": 3600, "extra": "10" } ], "NS": [ { "value": "a.iana-servers.net", "ttl": 86400, "extra": null } ] }, "has_mail": true, "spf": true, "dmarc": false, "parked_at": null } }`

## Webhook uçları

Olayların gideceği adresleri yönetir. Gövde, imza ve yeniden deneme kuralları webhook sayfasında anlatılır.

### Webhook uçların

GET `/webhooks`

```
curl "https://hunter.domains/api/v1/webhooks" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "id": 3, "url": "https://hooks.example.com/hunter", "events": [ "alert.matched", "domain.available" ], "active": true, "disabled_at": null, "consecutive_failures": 0, "last_delivered_at": "2026-10-06T16:44:03Z", "created_at": "2026-10-03T10:25:00Z" } ] }`

### Webhook ucu ekle Pro

POST `/webhooks`

En çok 3 uç. İmza anahtarı (`secret`) yalnızca bu cevapta, bir kez döner; sakla.

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `url` gövde · zorunlu | string | Herkese açık bir sunucuda `https://` adresi. |
| `events` gövde | string[] | Gönderilecek olaylar. Varsayılan: hepsi. Değerler: `alert.matched`, `domain.available`, `domain.ending_soon`, `check.completed`. |

```
curl -X POST "https://hunter.domains/api/v1/webhooks" \
  -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hooks.example.com/hunter","events":["alert.matched","domain.available"]}'
```

**Cevap · 201**

`{ "data": { "id": 3, "url": "https://hooks.example.com/hunter", "events": [ "alert.matched", "domain.available" ], "active": true, "disabled_at": null, "consecutive_failures": 0, "last_delivered_at": "2026-10-06T16:44:03Z", "created_at": "2026-10-03T10:25:00Z", "secret": "whsec_3Qd…" } }`

### Tek bir webhook ucu

GET `/webhooks/{id}`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Ucun kimliği. |

```
curl "https://hunter.domains/api/v1/webhooks/12" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "id": 3, "url": "https://hooks.example.com/hunter", "events": [ "alert.matched", "domain.available" ], "active": true, "disabled_at": null, "consecutive_failures": 0, "last_delivered_at": "2026-10-06T16:44:03Z", "created_at": "2026-10-03T10:25:00Z" } }`

### Ucu değiştir ya da yeniden aç

PATCH `/webhooks/{id}`

Art arda 15 teslimatı başarısız olan uç kapatılır; yeniden açmak için `{"active": true}` gönder.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Ucun kimliği. |
| `url` gövde | string | Yeni adres. |
| `events` gövde | string[] | Yeni olay listesi. Değerler: `alert.matched`, `domain.available`, `domain.ending_soon`, `check.completed`. |
| `active` gövde | boolean | Teslimatı durdur ya da sürdür. |

```
curl -X PATCH "https://hunter.domains/api/v1/webhooks/12" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": { "id": 3, "url": "https://hooks.example.com/hunter", "events": [ "alert.matched", "domain.available" ], "active": true, "disabled_at": null, "consecutive_failures": 0, "last_delivered_at": "2026-10-06T16:44:03Z", "created_at": "2026-10-03T10:25:00Z" } }`

### Ucu sil

DELETE `/webhooks/{id}`

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Ucun kimliği. |

```
curl -X DELETE "https://hunter.domains/api/v1/webhooks/12" \
  -H "Authorization: Bearer hd_…"
```

204 · Gövde dönmez.

### Deneme olayı gönder

POST `/webhooks/{id}/test`

Uca, abone olduğu olaylardan bağımsız bir `ping` olayı gönderir.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Ucun kimliği. |

```
curl -X POST "https://hunter.domains/api/v1/webhooks/12/test" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 202**

`{ "data": { "id": "evt_01k6x2f0q8m3r7t9v4b5n6c8dz", "event": "ping", "status": "pending", "attempts": 0, "response_code": null, "error": null, "created_at": "2026-10-06T16:44:02Z", "delivered_at": null } }`

### Son teslimatlar

GET `/webhooks/{id}/deliveries`

Son 50 teslimat; durumu ve son denemenin cevap koduyla. 14 gün saklanır.

| Parametre | Tür | Açıklama |
| --- | --- | --- |
| `id` yol · zorunlu | integer | Ucun kimliği. |

```
curl "https://hunter.domains/api/v1/webhooks/12/deliveries" \
  -H "Authorization: Bearer hd_…"
```

**Cevap · 200**

`{ "data": [ { "id": "evt_01k6x2f0q8m3r7t9v4b5n6c8dz", "event": "alert.matched", "status": "delivered", "attempts": 1, "response_code": 200, "error": null, "created_at": "2026-10-06T16:44:02Z", "delivered_at": "2026-10-06T16:44:03Z" } ] }`

## Kullanım örnekleri

**Son çalışmadan beri yeni gelenleri al.** Son çağrının zamanını sakla ve `since` olarak gönder:

```
curl "https://hunter.domains/api/v1/domains?since=2026-10-06T00:00:00Z&sort=newest" \
  -H "Authorization: Bearer hd_…"
```

**Kendi nişinde ucuz düşenleri izle.** Liste filtrelerini birleştir:

```
curl "https://hunter.domains/api/v1/domains/available?topic=Health&lang=en&min_dr=25&clean=true" \
  -H "Authorization: Bearer hd_…"
```

**Teklif vermeden önce domaini kontrol et.** Kontrolü iste, sonra `status` değeri `done` olana kadar sorgula:

```
curl -X POST "https://hunter.domains/api/v1/checks" -H "Authorization: Bearer hd_…" \
  -H "Content-Type: application/json" -d '{"domain": "example.org"}'

curl "https://hunter.domains/api/v1/checks/01k6x2f0q8m3r7t9v4b5n6c8dz" -H "Authorization: Bearer hd_…"
```

Kontrol genellikle bir iki dakika sürer. En sık 10 saniyede bir sorgula ya da haberi `check.completed` [webhook'undan](https://hunter.domains/tr/docs/webhooks) al.

**Sorgulamayı tamamen bırak.** İstediğin domaini tarif eden bir alarm kuralı oluştur ve bir webhook adresi ekle. Eşleşmeler bulundukça adresine gelir.

## Sürümler

Sürüm yolda yazar: `/api/v1`. Bir sürümün içinde yalnızca çalışan istemciyi bozmayan değişiklikler yaparız: yeni uçlar, yeni isteğe bağlı parametreler ve cevaplarda yeni alanlar. İstemcileri bozacak bir değişiklik yeni sürüm olarak çıkar; eskisi kapatılmadan önce etkin anahtarı olan bütün hesaplara e-postayla haber veririz.

## Sık sorulan sorular

### Expired domainler için bir API var mı?

Evet. hunter.domains'in REST API'si, elenmiş expired domainlerden oluşan günlük listesini JSON olarak döndürür; her domainin puanı, Domain Rating, Trust Flow, yönlendiren domain sayısı, arşiv geçmişi ve risk bayraklarıyla. Düşüp hâlâ alınmamış domainleri ve adını verdiğin herhangi bir domainin tam raporunu da verir.

### API'nin ücreti ne kadar?

Ek ücreti yok, planına dahil. Ücretsiz plan günün 5 açık domainini, arşivi ve sorguları alır; Pro (aylık 9.99 dolar) tam listeyi, Şu an boşta listesini, alarm kurallarını ve webhook'u alır.

### Taradığınız bütün domainleri alabilir miyim?

Hayır. API, elemeyi geçen domainleri döndürür; bu da taranan iki milyon değil, günde birkaç düzine domain demektir. Değer, elenenlerdedir.

### Listenizde olmayan bir domaini kontrol edebilir miyim?

Evet, `POST /checks` ile. Herhangi bir domain için aynı geçmiş, spam, kara liste ve otorite incelemesini yapar ve bir kontrol hakkı harcar. Hak harcamadan hızlıca bakmak için `GET /tools/whois`, `/tools/availability` ve `/tools/domain-rating` ücretsizdir.

### Whois ya da müsaitlik API'si sunuyor musunuz?

`GET /tools/whois`, bir domainin kayıt bilgisini kayıt kurumundan RDAP ile canlı okur ve düşme tarihi tahminiyle birlikte döndürür. `GET /tools/availability`, tek istekte ücretsiz planda 20, Pro'da 50 domaini sorgular. İkisi de kayıt kurumu RDAP sunan uzantılarda çalışır:.com,.net,.org ve çoğu uzantı buna dahildir;.com.tr,.se,.nu,.it ve.es değildir.

### API'yi tarayıcıdan çağırabilir miyim?

Teknik olarak evet, ama yapma. Ön yüz kodundaki anahtarı sayfayı açan herkes okuyabilir. API'yi kendi sunucundan çağır, sonucu oradan ilet.

Güncellendi: 6 Ekim 2026

## Anahtarını al, ilk isteği at

Ücretsiz hesapla API anahtarı oluşturabilir, MCP sunucusunu asistanına bağlayabilirsin. Kart gerekmez.

[Ücretsiz hesap aç](https://hunter.domains/tr/register)

## Bir sonraki iyi domaini kaçırma.

Kuralını kur, gerisini bize bırak. Uyan domain bulunduğu an haberin olur.

[Ücretsiz başla](https://hunter.domains/tr/register)