Süresi dolmuş alan adları için webhook’lar

Bir alan adı eşleşince — veya bir fiyat hareket edince — POST gönderen Expired Domains webhook’ları

Public API ile aynı Pro anahtarla abone olun. Bir filtre eşleştiğinde, bir açık artırma değiştiğinde veya bir notu, favoriyi ya da kullanıcı görevini güncellediğinizde Karma.Domains imzalı bir JSON olayı Zapier, Make, n8n, IFTTT veya herhangi bir herkese açık HTTPS URL’sine gönderir.

Şunlarla çalışır
30 Abonelik
5.000 Günde teslimat
3 Abonelik türü
60/min Paylaşılan hız sınırı
Webhook bağla API anahtarı al
Yapay zekaya sor
  • ChatGPT
  • Claude
  • Gemini
  • Grok
  • Perplexity

Zapier, Make, n8n veya IFTTT bağlayın

Aracınızda bir webhook tetikleyicisi oluşturun, HTTPS URL’sini kopyalayın ve POST /v1/webhooks ile kaydedin. Aynı çağrı her istemci için çalışır — yalnızca URL değişir.

Pro plan veya üzeri gerekir. Anahtarı Profil → Geliştirici içinde oluşturun veya sıfırlayın. Parola gibi davranın.

Abonelikler Hesap başına 30
Teslimatlar UTC günü başına 5.000
Hız sınırı Anahtar başına dakikada 60 istek (Public API ve MCP ile ortak)

Zapier — Webhooks by Zapier, Catch Hook

  1. Bir Zap oluşturun ve tetikleyici olarak Webhooks by Zapier seçin. Catch Hook’u seçin.
  2. Zapier’in gösterdiği HTTPS webhook URL’sini kopyalayın.
  3. Pro anahtarınız, bu URL, bir kind ve istediğiniz olaylarla POST /v1/webhooks gönderin. İlk teslimattan sonra Zap’i test edin.
curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

Abone olmanın üç yolu

Bir olay bir rapordur; kullanıcı görevi olayları hariç, onlarda görev başına bir olay vardır. Sır yalnızca aboneliği oluşturduğunuzda veya döndürdüğünüzde döner.

Filtre eşleşmesi

kind=filter, bir rapor POST /v1/reports/search ile aynı filtrelere uymaya başlayınca domain.matched_filter gönderir. İmleç abone olduğunuz anda başlar, eski satırlar yeniden oynatılmaz. Filtreden çıktıktan sonra yeniden eşleşen bir rapor yine tetiklenebilir.

Abone ol

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://hooks.example.com/karma",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

Aldığınız olay

{
  "id": "evt_example",
  "type": "domain.matched_filter",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "domain": "example.com",
    "report_id": "665f0example",
    "report_type": "expired"
  },
  "data": { "current": { "changed_at": 1710000000 } },
  "links": { "report": "https://karma.domains/app/reports/expired/report-665f0example/" }
}

Belirli bir rapor

kind=reports en fazla 100 raporu izler. Açık artırma olayları fiyatı, teklif sayısını, bitmek üzere olmayı ve bitişi kapsar. Not, etiket ve favori olayları yalnızca değişikliği yapan hesap için tetiklenir — aynı raporu fiyat için izleyen başka bir hesap bunları almaz. ending_soon_seconds yalnızca auction.ending_soon seçtiğinizde zorunludur.

Abone ol

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "reports",
    "url": "https://hooks.example.com/karma",
    "events": ["auction.price_changed", "report.note_changed"],
    "reports": [{ "report_type": "auctions", "report_id": "665f0example" }]
  }'

Aldığınız olay

{
  "id": "evt_example",
  "type": "auction.price_changed",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "domain": "example.com",
    "report_id": "665f0example",
    "report_type": "auctions"
  },
  "data": {
    "current": { "price": 120, "bid_count": 4 },
    "previous": { "price": 100, "bid_count": 3 },
    "changes": { "price_delta": 20, "bid_count_delta": 1 }
  }
}

Kullanıcı görevleri

kind=user filtre ve rapor listesi içermez. usertask.created bir görev kaydedildiğinde bir kez tetiklenir. usertask.completed bittiğinde bir kez tetiklenir. İlerleme tikleri gönderilmez. Yük, görevdeki her alan adını değil, görevin adını ve rapor sayısını verir.

Abone ol

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "user",
    "url": "https://hooks.example.com/karma",
    "events": ["usertask.created", "usertask.completed"]
  }'

Aldığınız olay

{
  "id": "evt_example",
  "type": "usertask.completed",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "task_id": "665f0task",
    "report_type": "expired"
  },
  "data": {
    "current": { "task_name": "French plumbing", "reports_count": 12 }
  }
}

Teslimatlar Standard Webhooks ile imzalanır. Her POST webhook-id, webhook-timestamp ve webhook-signature içerir. whsec_ sırrı bir kez döner, oluştururken ve döndürürken. URL’yi doğrulamak için webhook.ping teslim etmek üzere POST /v1/webhooks/{id}/ping gönderin.

Sıkça sorulan sorular

Bu, Public API ile aynı anahtar mı?

Evet. REST, MCP ve webhook’lar için Profil → Geliştirici’dan tek bir Pro anahtar. Abonelik oluşturmak ve güncellemek, paylaşılan dakikada 60 isteğe sayılır.

Webhook sınırları nelerdir?

Hesap başına 30 abonelik ve UTC günü başına 5.000 teslimat. Günlük tavan aşılınca abonelik sonraki UTC gününe kadar quota_paused olur. Bir aboneliği PATCH ile kendiniz duraklatabilirsiniz.

Hangi olaylara abone olabilirim?

kind=filter yalnızca domain.matched_filter kabul eder. kind=reports auction.price_changed, auction.bid_count_changed, auction.ending_soon, auction.ended, report.note_changed, report.tags_changed ve report.favorite_changed kabul eder. kind=user usertask.created ve usertask.completed kabul eder.

Olayda Majestic (veya başka bir metrik) neden yok?

Rapor verisi tek seferde değil, arka planda gelir. Bir metrik istemeyen filtre, o metrik var olmadan eşleşebilir. Düşük öncelikli bir rapor onu hiç almayabilir.

Zorunlu bir metriği filtreye koymalı mıyım?

Yalnızca onu zaten taşıyan raporları istiyorsanız evet. Bu, kümeyi daraltır ve olayı metrik toplanana kadar geciktirebilir. Süresi dolmuş alan adlarında gecikme önemlidir — beklerken ad akıştan çıkabilir. En erken sinyali istiyorsanız metriği dışarıda bırakın ve POST’tan sonra kendiniz kontrol edin.

Metrikler genellikle hangi sırayla görünür?

Önce açık artırma verisi, sonra Karma Metric, sonra Karma Score ve arşiv içeriği, sonra SEO metrikleri (Majestic, Moz, Ahrefs ve geri kalanı), sonra Google verisi. Sabit bir bekleme yoktur. Daha sonraki bir adım atlanabilir.

Not ve favori olayları o raporu izleyen herkese gider mi?

Hayır. Bu olaylar yalnızca notu, etiketleri veya favoriyi değiştiren hesabın aboneliklerine gider. Aynı raporu fiyat için izleyen bir izleme, açık artırma olaylarında kalır.

İstek şeması nerede?

Türler ve bir try-it konsolu Swagger UI içindedir. Public API sayfası aramayı, raporları ve REST’in geri kalanını kapsar.

Uygulamadaki envanterin aynısı — URL’nize itilir

Bir HTTPS uç noktası kaydedin ve olay almaya başlayın

Bir Pro anahtar. 30 abonelik. Günde 5.000 teslimat.

Pro Gerekli plan
30 Abonelik
5.000 Günde teslimat
API anahtarınızı alın

Veriyi kendiniz çekmek mi istiyorsunuz? Public API’ye bakın

Sohbet mi tercih edersiniz? MCP sunucusuna bakın