İçeriğe geç
SEO Uptr
SEO UptrKaydol

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.

Altından küçük bir tekne geçen bir taş köprü

Kredi maliyetine göre işlemler

1 kredi = $0.0001. Her çağrı, çağrı başına 1.000 satıra kadar olmak üzere, satır sayısından bağımsız olarak tek seferde faturalandırılır.
MaliyetİşlemlerNotlar
Ücretsiz, anahtar gerektirmezdomain, overview, stats, suggestPanolar ve DR kontrol aracı için uygundur
1 kredibulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr 2.000'e kadar alan adı alır (GET domains= veya POST gövdesi); compare 20'ye kadar
2 kredirefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect 2 ile 10 alan adı alır
3 kredisearch, keywordBağ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.

bash
# 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" ;;
esac

Parametreler ve hatalar

ÖğeDeğerAnlam
qbir alan adıArama hedefi
page, perper 10 ile 5000 arasındaSayfalama; çağrı başına satır sayısı 1.000 ile sınırlıdır, derin sayfalama 50.000'e kadar
sort, orderorder=asc veya descDönen satırların sıralanması
okher yanıttaÇağrının başarılı olup olmadığı
_creditsyalnızca kimliği doğrulanmış yanıtlarÇağrının maliyeti ve kalan bakiye
HTTP 401eksik veya hatalı anahtarAnahtarı veya başlığı kontrol edin
HTTP 402kredi tükendiUSDT (TRC-20) ile yükleyin
Atölye tezgahında ahşap ölçen ve aletler seçen bir marangoz

Ç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.

Önce ücretsiz eylemler

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.
Bahçede bitkileri düzenli sıralar halinde düzenleyen bir bahçıvan

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?
overview veya domain ile 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 sonra refdomains veya anchors iç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ı, bir anchors çağrısı ve bir tld_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. page ile per kullanı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.