Tüketimi sınırla

Ahrefs API, uygun ücretli planlarda kullanılabilir. Diğer tüm planlarda ise, sınırlı sayıdaki ücretsiz test sorgusuna yine erişebilirsiniz.

free test queries ile Rank Tracker, Management, Public ve bazı diğer uç noktalar haricindeki tüm istekler API birimleri tüketir. Bir uç nokta ücretsizse, dokümantasyon sayfasında bununla ilgili bir not görürsünüz; değilse birim tüketir.

İstek başına birim tüketimi şu şekilde hesaplanır:

max(base_cost, per_row_cost * num_rows)

Her isteğin base_cost değeri 50 birimdir. per_row_cost, dönen sonuçta yer alan veya where ya da order_by parametrelerinde kullanılan her bir benzersiz alanın maliyetlerinin toplamıdır. Bir alan birden fazla parametrede yer alıyorsa, yalnızca bir kez sayılır.

Bir alanın varsayılan maliyeti 1 birimdir. Ancak bazı metrikler daha maliyetlidir ve 5 veya 10 birim tüketebilir. Bu tür istisnalar, her uç noktanın alan açıklamasında belirtilir. Önbellekten karşılanan istekler birim tüketmez.

Her API isteği, birim tüketim davranışını aşağıdaki yanıt başlıklarıyla belirtir:

x-api-rows Döndürülen satır sayısı.
x-api-units-cost-row Satır başına birim maliyeti.
x-api-units-cost-total Satır sayısına ve satır başına maliyete göre isteğin tüketmesi gereken toplam birim sayısı.
x-api-units-cost-total-actual İsteğin gerçekte tükettiği toplam birim sayısı.
x-api-cache İsteğin önbellekten yanıtlanıp yanıtlanmadığı. Şunlardan biri: hit miss no_cache

info

Bir isteğin maliyetini tahmin etmenin iyi bir yolu, isteği bir ücretsiz hedef ile çalıştırıp x-api-units-cost-total alanının değerini kontrol etmektir. curl komutunu kullanırken yanıt başlıklarını görüntülemek için -v veya --verbose seçeneğini kullanabilirsiniz.

Örnek 1

Site Explorer - Etki Alanı Derecelendirmesi uç noktasına (/site-explorer/domain-rating) yapılan bir isteği ele alalım.

select, where veya order_by parametrelerini kabul etmez ve satır başına maliyeti 2 birim olacak şekilde, domain_rating ve ahrefs_rank olmak üzere iki alan içeren tek bir satır döndürür.

Toplam satır maliyeti (satır başına maliyetin satır sayısıyla çarpımı) taban maliyetten daha düşüktür. Bu nedenle, bu isteğin maliyeti taban tutar olan 50 birimdir.

Örnek 2

select, where ve order_by parametrelerinin yapılandırılmasına izin veren Site Explorer - Geri Bağlantılar uç noktasına (/site-explorer/all-backlinks) yapılan daha karmaşık bir isteği ele alalım.

Bu istekte iki alanın seçildiğini varsayalım:

select=title,traffic

filtre ifadesindeki iki alan:

where={"and":[{"field":"traffic","is":["gt",1000]},{"field":"refdomains_source","is":["gt",10]}]}

ve bir sıralama alanı:

order_by=traffic:desc

Bu parametreler genelinde üç benzersiz alan vardır; title ve refdomains_source alanlarının her biri 1 birime mal olurken, traffic alanı 10 birime mal olur. Dolayısıyla satır başına maliyet 1 + 1 + 10 = 12 birimdir.

İsteğin 500 satır döndürdüğünü varsayalım. Bu durumda, toplam satır maliyeti (12 * 500 = 6000 birim) taban maliyeti aşar. Bu nedenle, bu isteğin maliyeti 6000 birimdir.