Topik

API + MCP

GET/v3/content-helper/topics

Titik akhir ini menggunakan jumlah dasar 1000 unit per permintaan, ditambah 500 unit jika Anda meminta URL untuk dinilai.

Analisis berjalan sesuai permintaan terhadap halaman yang saat ini berperingkat untuk kata kunci tersebut, jadi permintaan pertama untuk sebuah kata kunci memerlukan beberapa detik. Hasilnya disimpan dalam cache, dan permintaan berulang dilayani dari cache tanpa biaya.

Hanya SERP yang sudah dikumpulkan Ahrefs yang digunakan, dan tidak ada SERP baru yang dikumpulkan. Jika kami telah mengumpulkan SERP untuk kata kunci dan negara tersebut dalam 90 hari terakhir, titik akhir ini akan mengembalikan error 400 dan tidak ada unit yang digunakan.

Parameter kueri

keywordstringWajib

Kata kunci untuk menganalisis SERP-nya.

countrystringWajib

Kode negara dua huruf (ISO 3166-1 alpha-2).

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Berapa banyak halaman dengan peringkat teratas yang akan dianalisis. Semakin sedikit halaman, analisis semakin cepat, tetapi cakupannya berkurang.

Default:10

target_urlstring (url)

(500 unit) Halaman milik Anda sendiri untuk dinilai terhadap topik yang sama, misalnya draf yang sedang Anda tulis atau halaman yang ingin Anda tingkatkan. Halaman diambil secara langsung. Ini menghabiskan unit API tambahan setiap kali (penilaiannya tidak disimpan dalam cache).

outputstring

Format output.

Nilai yang diizinkan:jsonphp

Respons

topicsarray<object>

avg_scorenumber (float)

Skor cakupan rata-rata untuk topik ini, dari 0 hingga 100, pada halaman yang bisa dianalisis. Nilai yang tinggi berarti topik ini dibahas secara menyeluruh oleh halaman yang sudah berperingkat. Bernilai null jika tidak ada halaman yang bisa dianalisis.

descriptionstring

Tentang apa topik inti tersebut, sebagaimana diidentifikasi dari halaman pesaing.

pagesarray<object>

Cakupan topik ini per halaman: sebuah record dengan kolom url, position (posisi SERP halaman), score (0-100) dan extracts (cuplikan dari halaman yang membahas topik). score dan extracts bernilai null dan kosong untuk halaman yang kontennya tidak bisa diambil, yang berbeda dengan halaman yang skornya nol.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Jumlah halaman yang dianalisis dan membahas topik ini (skor bukan nol).

serp_datestring (date)

Kapan SERP yang dianalisis dikumpulkan.

targetobject or null

Bagaimana halaman yang diberikan sebagai target_url membahas topik ini. Bernilai null jika target_url tidak diberikan.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

Nama topik inti yang dibahas oleh halaman dengan peringkat teratas.