Referans
Backlinkler API referansı: işlemler, maliyetler ve hatalar
Bir izleyicinin bilmesi gereken gerçekler için tek sayfa: her işlemin maliyeti, sayfalamanın nasıl çalıştığı ve API bir hata durumunda ne yapar.

Kredi maliyetine göre işlemler
| Maliyet | İşlemler | Notlar |
|---|---|---|
| Ücretsiz, anahtar gerektirmez | domain, overview, stats, suggest | Panolar ve DR kontrol aracı için uygundur |
| 1 kredi | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr 2.000'e kadar alan adı alır (GET domains= veya POST gövdesi); compare 20'ye kadar |
| 2 kredi | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect 2 ile 10 alan adı alır |
| 3 kredi | search, keyword | Bağlantı metinleri, başlıklar ve URL'ler üzerinde tam metin araması; keyword tam bir bağlantı metni ile bağlantı kurulanları bulur |
Kimlik doğrulama ve durum kodları
Anahtarı key= olarak veya bearer başlığı olarak iletin. Gövdeyi parse etmeden önce HTTP kodunu kontrol edin.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacParametreler ve hatalar
| Öğe | Değer | Anlam |
|---|---|---|
q | bir alan adı | Arama hedefi |
page, per | per 10 ile 5000 arasında | Sayfalama; çağrı başına satır sayısı 1.000 ile sınırlıdır, derin sayfalama 50.000'e kadar |
sort, order | order=asc veya desc | Dönen satırların sıralanması |
ok | her yanıtta | Çağrının başarılı olup olmadığı |
_credits | yalnızca kimliği doğrulanmış yanıtlar | Çağrının maliyeti ve kalan bakiye |
| HTTP 401 | eksik veya hatalı anahtar | Anahtarı veya başlığı kontrol edin |
| HTTP 402 | kredi tükendi | USDT (TRC-20) ile yükleyin |

Çağrıyı zamanlamadan önce tasarlayın
API sorunlarının çoğu istekte başlar. Yanıtta değil. Bir seo backlinks api entegrasyonu, ilk çağrıdan önce yapılan küçük kararlar kümesidir. Anahtarı, sayfa boyutunu ve sıralama düzenini önce belirleyin.
Anahtarı betikten uzak tutun
Anahtarı ortam değişkeninde veya gizli depolamada saklayın, commit edilen bir dosyada değil. key parametresi veya bearer başlığı olarak iletin. Başlık, anahtarı günlüklerde sona erme eğilimindeki adreslerin dışında tutar.
Canlı anahtarı bir bilet veya sohbete yapıştırmayın. Paylaşılan bir günlükte görünen bir anahtarı açığa çıkmış olarak kabul edin.
Sayfa boyutunu bilinçli seçin
per parametresi 10 ile 5000 arasında çalışır, ancak bir çağrı 1.000 satıra kadar için tek seferde faturalandırılır, bu nedenle daha büyük sayfalar daha az ücret anlamına gelir. 3.400 satır gerektiğini varsayalım. Bu, 10'da 340 çağrı yerine, 1.000 satırda dört çağrı alır.
Dosyaların hizalanması için sayfa boyutunu çalışmalar boyunca aynı tutun.
Sıralama düzenini sabitleyin
sort ve order parametrelerini açıkça belirtin, varsayılanlara güvenmeyin. Aynı parametreler, haftadan haftaya karşılaştırılabilir bir çıktı sağlar; böylece bir fark analizi gerçek değişimi gösterir, satırların yeniden sıralanmasından kaynaklanan bir yanılgıyı değil.
Değişen bir sıralama, kolayca yanlış alarm oluşturmanın bir yoludur.
Sayıları okumak
Verilerimize ait bağlantı grafiğimiz şunları içerir: 181.132.097 alan adı, 2.774.625.913 alan adı arası bağlantı ve yaklaşık 798,5 milyar geri bağlantı. Veriler ayda bir kez güncellenir. Bundan daha yeni veriler burada yer almaz; bu nedenle bir seo backlinks api haftalık olarak sorgulanmalıdır.
DR, round(100 · log(ref_domains+1) / log(2·10^7)) formülüyle hesaplanır. Bu bir logaritma değeridir. Bu nedenle 100 yönlendiren alan adı 27 puan, 1.000 alan adı 41 puan ve 10.000 alan adı 55 puan alır; link sayınızı iki katına çıkarmak yalnızca birkaç puan ekler. DR'yi siteleri birbirine göre sıralamak için kullanın, uyarılar için ise ham sayıları kullanın; şiddet tablosu bu şekilde çalışır.
Fiyatlandırma peşin ödemelidir. Abonelik yoktur, minimum tutum yoktur. Kayıt olduğunuzda verilen kredi bakiyesi 100 $'dır ve bu 1.000.000 krediye eşittir. Bunu Ahrefs API birimleriyle karşılaştırın: planların içinde satılan birimler ayda 129 $'dan başlayan fiyatlarla 200.000 birim sunar ve her istekte en az 50 birim gerekir.
Maliyet planlaması basit bir çarpımdan ibarettir. Bir site için haftalık bir refdomains çağrısı 2 kredi × 4 hafta = ayda 8 kredi eder; bu da 0,0008 $'dır. On site bu maliyetin on katıdır. Kayıp link tarifi ve rakip işi yukarıdaki tabloda yer alan eylemleri yalnızca kullanır.
Bir hatayı tahmin etmeden okumak
Bir hata kodu, kimin harekete geçmesi gerektiğini söyler. Hata kodunu bu şekilde okuyun. Yanıt bir bulmacadan ziyade bir yönlendirme kararı haline gelir. Bir monitör için en önemli iki kod 401 ve 402'dir.
401 ve 402 farklı sorunlardır
401, anahtarın eksik veya yanlış olduğu anlamına gelir ve biri düzeltene kadar hiçbir şey başarılı olmaz. 402 ise hesabın kredisinin bittiği anlamına gelir; bir üst ödeme (top-up) sorunu çözer. Bu hataları farklı sahiplere yönlendirin ki mesajı doğru kişi görsün.
Her iki durumu da bir kişiye iletin. Sessizce başarısız olan bir monitör, hiç çalışmayan bir monitörden daha kötüdür.
İçeriği kontrol etmeden önce durumu kontrol edin
Önce HTTP durumunu, sonra ok alanını okuyun. Bir yanıt JSON olarak ayrıştırılabilir ve yine de bir hatayı içerebilir; bu nedenle kontrol, her iki alan da başarılı olduğunda tamamlanmış olur. Başarılı olanlar da dahil olmak üzere her çalıştırmada durumu günlüğe kaydedin.
Yalnızca kurtarılabilir olanları yeniden dene
Bir 401'i yeniden denemek çağrıları boşa harcar ve günlükleri aynı hatayla doldurur. Bir ağ zaman aşımı farklı bir durumdur. Bunu birkaç kez, denemeler arasında bekleme süresi koyarak yeniden deneyin, sonra durun.
Durduran ve uyarı veren bir çalıştırma, hatayı bakiye bitene kadar gizleyen bir yeniden deneme döngüsünden daha faydalıdır.
Her çalıştırmada durumu günlüğe kaydedin
Başarılı olanlar da dahil olmak üzere her çalıştırmada HTTP durumunu ve bakiyeyi günlüğe yazın. Bir çalıştırma üç hafta sonra başarısız olduğunda, görmek isteyeceğiniz ilk satım budur.
domain, overview, stats ve suggest anahtar gerektirmez ve ücretsizdir. Bunları, tek bir kredilik ücretli bir eylem harcamadan önce bir alan adını, tam bir yazımı veya kabaca bir büyüklüğü kontrol etmek için kullanın.
Bir çağrıyı cron'a eklemeden önce
- Eylemin maliyeti bellidir ve aydaki çalıştırma sayısıyla çarpılır.
- Çıkış kodu ve HTTP durumu ikisi de kontrol edilir.
- Bir 402, bir insana uyarı gönderir.
- Yanıtlar sıralı olarak kaydedilir, böylece farklar temiz kalır.
- Periyot, aylık yenilemeyle eşleşir.

Sayfalama hakkında notlar
Sıralama önemlidir. Anlık görüntüler için per=1000 kullanın ve her hafta aynı sort ve order parametrelerini koruyun. Çalıştırmalar arasında sıralama değişirse, bir fark analizi gürültü gösterir. Bu, yanlış alarmın klasik bir nedenidir.
Daha büyük siteler? 1.000'den fazla yönlendiren alan adı olan bir site için page=1, page=2 vb. ile sayfalar arasında gezinin. Her sayfa ayrı bir ücretli çağrıdır. Derin sayfalama 50.000 satırda sınırlandırılmıştır; bu neredeyse tüm sıradan siteleri kapsar.
Referansla ilgili sorular
- Bir alan adının nasıl göründüğünden emin olmadığım durumda ilk olarak hangi eylemi çağırmalıyım?
overviewveyadomainile başlayın. İkisi de ücretsizdir ve anahtar gerektirmez; verilerin kabaca büyüklüğünü ve temel yapısını gösterirler. Kredileri ancak bundan sonrarefdomainsveyaanchorsiçin harcayın.- Tek bir alan adının tam bir kontrolü ne kadar maliyetlidir?
- Her eylemin kredi maliyetlerini toplayın, sonra ne sıklıkta çalıştığını sayıyla çarpın. Bir alan adı için haftalık bir
refdomainsçağrısı, biranchorsçağrısı ve birtld_breakdownçağrısını düşünün. Bu, bir çalıştırmada 2 + 2 + 1 = 5 kredi eder; yani 0,0005 $. Dört hafta içinde bu yaklaşık 0,002 $'a gelir. - Aynı alan adı için iki sayı neden eşleşmeyebilir?
- Benzeri benzeriyle karşılaştırın: aynı eylem, aynı parametreler ve aynı yenileme periyodu. Farklı eylemlerden gelen sayılar birbirinin yerine kullanılamaz; yenileme sırasında alınan bir sayı, bir hafta sonra alınan bir sayıdan farklı olabilir.
- Kredi harcamadan bir cron işini nasıl test ederim?
- Bağlantıları, durum işleme ve çıktı formatını kontrol etmek için önce ücretsiz eylemleri çalıştırın. Ardından sayıları kanıtlamak için tek bir ücretli çağrı yapın ve test sırasında işi tek bir çalıştırmayla sınırlayın.
- 1.000'den fazla yönlendiren alan adı olan bir site için sayfalama çalışır mı?
- Evet.
pageileperkullanın. Her sayfa ayrı bir ücretli çağrıdır ve derin sayfalama 50.000 satırda sınırlandırılmıştır; bu çoğu sıradan siteyi kapsar.
Kötü bir haftayı atlatan bir monitör
Bir monitör, hiçbir şeyin doğru gitmediği haftalarda güven kazanır. İlk çalışmadan önce yavaş bir yanıt, değişen bir bakiye ve kısmi bir sonuç için plan yapın. Bunlar olağan olaylardır. Her biri, günlükde açık bir satır bırakmalıdır.
Zaman aşimleri ve kısmi çekimler
Her çağrıya bir zaman aşımı ayarlayın böylece tek bir yavaş yanıt tüm işi açık tutamaz. Çok sayfalı bir çekimde bir sayfa başarısız olursa, hangi sayfa olduğunu kaydedin ve oradan yeniden başlatın. Böylece zaten sahip olduğunuz satırlar için iki kez ödeme yapmaktan kaçınmış olursunuz.
Kısmi bir dosyayı normal bir anlık görüntü olarak kaydetmek yerine kısmi olarak işaretleyin. Aksi halde bir sonraki fark analizi, hiç yaşanmayan bir kaybı gösterecektir.
Bakiye kontrolleri
Her kimlik doğrulaması gerektiren yanıtta _credits değerini okuyun ve kalan bakiyeyi günlüğe yazın. Küçük bir betik, bunu seçtiğiniz bir alt sınır ile karşılaştırabilir ve bir sonraki çalışmadan önce uyarı gönderebilir.
Alt sınırın 500 kredi olduğunu varsayın. Maliyeti 40 kredi olan haftalık bir çalıştırma, gece yarısında bir 402 hatası gelmeden önce üst ödeme yapmaya olanak tanır.
Her işi sıkıcı tutun
Her işe bir dosya ve bir zamanlama verin. Üç şey yapan bir cron girişi üç şekilde başarısız olabilir ve günlük her zaman hangisinin gerçekleştiğini söylemeyebilir. İki küçük iş, tek bir akıllı işden daha kolay güvenilir.
Zamanlamayı yenilemeyle eşleştirin
İşin zamanlamasını saate değil, aylık yenilemeye eşleştirin. Günlük bir çalıştırma çoğu gün aynı dosyayı döndürür; bu bilgi eklemeden maliyet ve gürültü ekler. Haftalık genellikle yeterlidir.