Konular

API + MCP

GET/v3/content-helper/topics

Bu uç nokta, istek başına 1000 birimlik temel bir miktar tüketir; ayrıca puanlama yapmak için bir URL isterseniz 500 birim daha tüketir.

Analiz, anahtar kelime için hâlihazırda sıralanan sayfalara karşı talep üzerine çalıştırılır; bu nedenle bir anahtar kelime için ilk istek birkaç saniye sürer. Sonuçlar önbelleğe alınır ve tekrarlanan istekler ücretsiz olarak önbellekten karşılanır.

Yalnızca Ahrefs’in daha önce topladığı SERP’ler kullanılır ve yeni bir SERP toplanmaz. Son 90 gün içinde anahtar kelime ve ülke için bir SERP topladıysak, uç nokta 400 hatası döndürür ve hiçbir birim tüketilmez.

Sorgu parametreleri

keywordstringGerekli

SERP’i analiz edilecek anahtar kelime.

countrystringGerekli

İki harfli ülke kodu (ISO 3166-1 alpha-2).

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Analiz edilecek en üst sıralardaki sayfa sayısı. Daha az sayfa, kapsamdan ödün vererek analizi hızlandırır.

Varsayılan:10

target_urlstring (url)

(500 birim) Örneğin yazdığınız bir taslak ya da geliştirmek istediğiniz bir sayfa gibi, aynı konulara göre puanlanacak kendi sayfanız. Sayfa canlı olarak getirilir. Her seferinde ek API birimi maliyeti doğurur (puanlaması önbelleğe alınmaz).

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

topicsarray<object>

avg_scorenumber (float)

Analiz edilebilen sayfalar arasında bu konunun 0–100 arası ortalama kapsam puanı. Yüksek bir değer, hâlihazırda sıralanan sayfaların konuyu kapsamlı şekilde ele aldığını gösterir. Sayfaların hiçbirinin analiz edilemediği durumda null olur.

descriptionstring

Rekabetçi sayfalardan tespit edildiği üzere, temel konunun ne hakkında olduğu.

pagesarray<object>

Bu konunun sayfa bazında kapsamı: url, position (sayfanın SERP konumu), score (0–100) ve extracts (sayfadan konuyu ele alan pasajlar) alanlarını içeren bir kayıt. İçeriği alınamayan bir sayfada score null, extracts ise boş olur; bu, puanı sıfır olan bir sayfadan farklıdır.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Analiz edilen sayfalardan kaçının bu konuyu en azından bir ölçüde ele aldığı (sıfır olmayan puan).

serp_datestring (date)

Analiz edilen SERP’in ne zaman toplandığı.

targetobject or null

target_url olarak verilen sayfanın bu konuyu nasıl ele aldığı. target_url verilmediyse null olur.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

En üst sıralardaki sayfaların ele aldığı temel konunun adı.