Ahrefs bağlama: API v3 anahtarı, veri türleri ve birim sınırı
Kendi Ahrefs API v3 anahtarını veri kaynağı olarak bağla; hangi veri türlerini karşıladığını, her işlemin kaç API birimi harcadığını ve aylık birim sınırını nasıl koyacağını öğren.
Bu ekranı panelde açAhrefs aboneliğin varsa, onun verisini SEOAsist'te veri kaynağı olarak kullanabilirsin. SEOAsist o veriyle sıralamayı izler, içerik açığını çıkarır, düzeltmeleri uygular ve sonucu raporlar. Bağlantı isteğe bağlıdır ve senin kendi API v3 anahtarınla çalışır: her çağrı Ahrefs hesabındaki API biriminden düşer.
Bağlamak tek başına hiçbir şeyi değiştirmez. Entegrasyonlar → Veri sekmesindeki Veri kaynakları tablosunda, Ahrefs'i hangi veri türü için kullanacağını sen seçersin. Seçmediğin sürece ücretli kaynağa geçilmez.
Hangi veri türlerini karşılar?
| Veri türü | Ahrefs API v3 uç noktası | Kalite |
|---|---|---|
| Sıralama takibi | Site Explorer → organic-keywords (en iyi pozisyon ve URL) | Yaklaşık: Ahrefs veritabanındaki pozisyonlar; canlı SERP kontrolü değildir |
| Hacim / CPC / KD | Keywords Explorer → overview | Tam |
| Kelime fikirleri | Keywords Explorer → related-terms, uzun kuyruk için matching-terms | Tam |
| Rakipler ve içerik açığı | Site Explorer → organic-competitors, iki alan adının organic-keywords listesi | Tam |
| Backlinkler | Site Explorer → backlinks-stats, domain-rating, all-backlinks (alan adı başına bir link, son 90 günde kaybedilenler dahil), refdomains | Tam (Ahrefs'in spam işareti toksik olarak gösterilir) |
Yerel harita gridi Ahrefs ile çalışmaz; o veri türü için DataForSEO gerekir. Domain Rating (0–100) backlink ekranında rank sütununda görünür.
Ön koşullar
- API v3 erişimi olan bir Ahrefs hesabı (Enterprise planı ya da API eklentisi).
- SEOAsist'te yönetici yetkisi.
API anahtarını almak
- app.ahrefs.com'a giriş yap.
- Account settings → API keys bölümünü aç (yalnızca çalışma alanı sahibi ya da yöneticisi anahtar oluşturabilir).
- Yeni bir anahtar oluştur ve kopyala.
SEOAsist'e bağlamak
- Entegrasyonlar → Veri sekmesinde Ahrefs kartını aç.
- Anahtarı yapıştır ve Bağla'ya bas.
- SEOAsist kaydetmeden önce Ahrefs'in ücretsiz
limits-and-usageuç noktasını çağırır. Başarılıysa “Ahrefs bağlandı. Kalan birim: …” mesajı çıkar. - Aynı sekmedeki Veri kaynakları tablosunda istediğin veri türleri için Ahrefs (kendi hesabın) seç.
Anahtar şifreli saklanır ve tarayıcıya hiçbir zaman açık hâliyle gönderilmez. Bağlantıyı test et düğmesi kalan birimi gösterir ve birim harcamaz.
Hangi işlem kaç birim harcar?
Ahrefs her ücretli istek için en az 50 birim alır; satır başına maliyet seçilen alanların toplamıdır (çoğu alan 1, hacim / KD / niyet / trafik 10 birim). Aşağıdaki değerler üst sınır tahminleridir.
| İşlem | Uç nokta | En fazla |
|---|---|---|
| Kelime araştırması (Fikirler / Uzun kuyruk) | related-terms / matching-terms, satır başına 32 | 100 satır → 3.200 |
| Hacim / CPC / KD doldurma | overview, kelime başına 32 | 300 kelime → 9.600 |
| Sıralama kontrolü | organic-keywords, satır başına 3 | Günde 1 çekim, 1.000 satır → 3.000 |
| Rakipleri bul | organic-competitors, satır başına 13 | 15 satır → 195 |
| Rakip eşitleme | organic-keywords, satır başına 27 | Rakip başına 500 + kendi 1.000 satırın |
| Backlink eşitleme | backlinks-stats 50 + domain-rating 50 + all-backlinks satır başına 10 | 500 link → 5.100 |
| Backlink fırsatları | refdomains, satır başına 5 | Rakip başına 300 satır, en fazla 5 rakip |
Rakip eşitleme Ahrefs'te en pahalı işlemdir. Önce bir rakiple dene ve aylık sınır koy.
Aylık birim sınırı
Ahrefs kartında Aylık birim sınırı alanına bir sayı yaz ve Kaydet'e bas. SEOAsist her çağrıdan önce bu ayın tahmini kullanımını ve çağrının tahmini maliyetini toplar; sınır aşılacaksa çağrıyı göndermez ve sana bildirim gönderir. Alanı boş bırakırsan sınır yoktur. Kesin tüketimi app.ahrefs.com → API keys ekranında görürsün.
Hata durumları
| Mesaj | Ne demek | Ne yapmalı |
|---|---|---|
| API anahtarı reddedildi | HTTP 401: anahtar yanlış, süresi dolmuş ya da silinmiş | Yeni anahtar oluşturup bağla |
| API birimin bitti | Birim sınırına ulaşıldı | Ahrefs'te birim ekle ya da sıfırlanma tarihini bekle |
| API erişimi yok | HTTP 403: plan bu uç noktayı kapsamıyor | Ahrefs planını kontrol et |
| İstek limiti aşıldı | HTTP 429 (varsayılan dakikada 60 istek) | SEOAsist bekleyip yeniden dener |
| Aylık birim sınırına ulaşıldı | Senin koyduğun sınır | Sınırı yükselt ya da ay başını bekle |
Anahtar, birim ya da erişim hatasında ilgili sayfaların üstünde “Ahrefs çalışmıyor” uyarısı çıkar ve sahip günde bir kez bilgilendirilir. Seçili kaynak başarısız olduğunda ücretsiz kaynağa sessizce geçilmez.
Sık sorulanlar
Sıralama neden “Yaklaşık”?
Pozisyonlar Ahrefs veritabanından gelir; Ahrefs bunları kendi takvimiyle yeniler ve yalnızca bildiği kelimeleri kapsar. Günlük canlı SERP kontrolü istiyorsan sıralama için DataForSEO'yu seç.
Bağlantıyı nasıl kaldırırım?
Kartı aç, Kaldır'a bas ve onayla. Ahrefs seçili veri türleri varsayılan kaynağa döner; Ahrefs serisi saklanır ama devam etmez.
Ahrefs ücretini SEOAsist mi alıyor?
Hayır. Birimler doğrudan senin Ahrefs hesabından düşer. Bkz. Maliyetler.
İlgili yazılar
- Veri kaynakları: ücretsiz katman, Bing Webmaster ve isteğe bağlı DataForSEOSıralama, arama hacmi, kelime fikirleri, rakip konuları ve backlinklerin nereden geldiği, ücretsiz kaynakların neyi yapıp neyi yapamadığı, Bing Webmaster anahtarının nasıl ekleneceği ve DataForSEO'nun veri türü bazında nasıl seçileceği.
- Semrush bağlama: API anahtarı, veri türleri ve birim sınırıKendi Semrush API anahtarını veri kaynağı olarak bağla; hangi veri türlerini karşıladığını, her işlemin kaç API birimi harcadığını ve aylık birim sınırını nasıl koyacağını öğren.
- DataForSEO bağlama: API bilgileri, maliyetler ve bakiyeDataForSEO hesabını SEOAsist'e bağla; hangi modülleri açtığını, her işlemin kaç çağrı harcadığını ve bakiyeni nereden takip edeceğini öğren.
- Maliyetler: AI kotası, kendi anahtarların ve DataForSEOPlana dahil olanlar, kendi hesabından ödenenler ve aylık kotaların nasıl sayıldığı hakkında sık sorulan sorular.
- Backlinkler: sekmeler, Şimdi eşitle ve haftalık eşitlemeBacklinkler sayfasındaki sekmeleri, Şimdi eşitle düğmesinin arka planda ne yaptığını ve eşitleme başarısız olduğunda gelen bildirimi öğren.