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.
Bu ekranı panelde açSemrush 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 anahtarınla çalışır: her çağrı Semrush hesabındaki API biriminden düşer.
Bağlamak tek başına hiçbir şeyi değiştirmez. Entegrasyonlar → Veri sekmesindeki Veri kaynakları tablosunda, Semrush'ı 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ü | Semrush raporu | Kalite |
|---|---|---|
| Sıralama takibi | Domain Organic Search Keywords (domain_organic) | Yaklaşık: Semrush veritabanındaki pozisyonlar; canlı SERP kontrolü değildir |
| Hacim / CPC / KD | Batch Keyword Overview (phrase_these), KD eksikse Keyword Difficulty (phrase_kdi) | Tam |
| Kelime fikirleri | Related Keywords (phrase_related), uzun kuyruk için Broad Match (phrase_fullsearch) | Tam |
| Rakipler ve içerik açığı | Competitors in Organic Search (domain_organic_organic), iki alan adının domain_organic listesi | Tam |
| Backlinkler | Backlinks Overview, Backlinks, Referring Domains | Tam (spam puanı yok, toksik işareti konmaz) |
Yerel harita gridi Semrush ile çalışmaz; o veri türü için DataForSEO gerekir.
Ön koşullar
- API erişimi olan bir Semrush hesabı (Business planı ya da satın alınmış API birimi).
- SEOAsist'te yönetici yetkisi.
- Sitenin konumu Semrush'ın desteklediği bir veritabanına karşılık gelmeli (Türkiye, Azerbaycan, Almanya, ABD, Birleşik Krallık…). Desteklenmeyen konumda “Sitenin konumu desteklenmiyor” uyarısı çıkar.
API anahtarını almak
- semrush.com'a giriş yap.
- Subscription info → API units bölümünü aç.
- Oradaki API key değerini kopyala.
SEOAsist'e bağlamak
- Entegrasyonlar → Veri sekmesinde Semrush kartını aç.
- Anahtarı yapıştır ve Bağla'ya bas.
- SEOAsist kaydetmeden önce Semrush'a ücretsiz bir bakiye sorgusu gönderir. Başarılıysa “Semrush bağlandı. Kalan birim: …” mesajı çıkar.
- Aynı sekmedeki Veri kaynakları tablosunda istediğin veri türleri için Semrush (kendi hesabın) seç.
Anahtar şifreli saklanır ve tarayıcıya hiçbir zaman açık hâliyle gönderilmez; kartta yalnızca maskeli hâli görünür. Bağlantıyı test et düğmesi kalan API birimini gösterir ve birim harcamaz.
Hangi işlem kaç birim harcar?
Semrush birimleri dönen satır başına ücretlendirir. Aşağıdaki değerler Semrush'ın resmî birim tablosuna göre üst sınır tahminleridir.
| İşlem | Rapor | En fazla |
|---|---|---|
| Kelime araştırması (Fikirler) | phrase_related, satır başına 40 | 100 satır → 4.000 |
| Kelime araştırması (Uzun kuyruk) | phrase_fullsearch, satır başına 20 | 100 satır → 2.000 |
| Hacim / CPC / KD doldurma | phrase_these kelime başına 10 (+ KD eksikse phrase_kdi kelime başına 50) | 300 kelime |
| Sıralama kontrolü | domain_organic, satır başına 10 | Günde 1 çekim, 1.000 satır → 10.000 |
| Rakipleri bul | domain_organic_organic, satır başına 40 | 15 satır → 600 |
| Rakip eşitleme | domain_organic, satır başına 10 | Rakip başına 500 + kendi 1.000 satırın |
| Backlink eşitleme | Overview 40 + backlinks satır başına 40 | 200 link → 8.040 |
| Backlink fırsatları | backlinks_refdomains, satır başına 40 | Rakip başına 100 satır, en fazla 5 rakip |
Otomatik işler de birim harcar: takipli kelimelerin günlük sıralama çekimi ve haftalık backlink eşitlemesi. Aylık sınır koymak bunları da kapsar.
Aylık birim sınırı
Semrush 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. Kartın özetinde “Bu ay ~… / … birim” görünür. Alanı boş bırakırsan sınır yoktur.
Tahmin, Semrush'ın birim tablosundan hesaplanır; kesin tüketimi semrush.com → API units ekranında görürsün.
Hata durumları
| Mesaj | Ne demek | Ne yapmalı |
|---|---|---|
| API anahtarı reddedildi | Anahtar yanlış ya da iptal edilmiş (ERROR 120) | Anahtarı yeniden kopyalayıp bağla |
| API birimin bitti | Bakiye sıfır ya da toplam sınır aşıldı (ERROR 132 / 134) | semrush.com'dan birim yükle |
| API erişimi yok | Plan ya da rapor türü kapalı (ERROR 130 / 133 / 135) | Semrush planını kontrol et |
| İstek limiti aşıldı | Çok fazla istek | SEOAsist bekleyip yeniden dener; sürerse birkaç dakika sonra tekrar dene |
| 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, bakiye ya da erişim hatasında ilgili sayfaların üstünde “Semrush ç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: grafikler karışık seri göstermesin diye veri sorun çözülene kadar eski kalır.
Sık sorulanlar
Sıralama neden “Yaklaşık”?
Pozisyonlar Semrush veritabanından gelir. Semrush bu veriyi kendi takvimiyle yeniler ve yalnızca bildiği kelimeleri kapsar; listede olmayan takipli kelime “sıralamada yok” görünür. 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. Semrush seçili veri türleri varsayılan kaynağa döner; Semrush serisi saklanır ama devam etmez.
Semrush ücretini SEOAsist mi alıyor?
Hayır. Birimler doğrudan senin Semrush hesabından düşer; SEOAsist plan ücretinden ayrıdır. 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.
- 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.
- 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.
- Anahtar kelime takibi, araştırma ve SERP pozisyonlarıSearch Console sorgularını incelemek, kelimeleri günlük SERP takibine almak ve yeni kelime fikirleri bulmak için Anahtar Kelimeler sayfasının kullanımı.