Respons AI

API + MCP

GET/v3/brand-radar/ai-responses

Permintaan ke endpoint ini akan menghabiskan unit API berdasarkan parameter prompts: permintaan yang hanya mengembalikan data prompt kustom gratis, sedangkan permintaan yang menyertakan data prompt Ahrefs mengikuti penetapan harga unit API Standard.

Parameter kueri

selectstringWajib

Daftar kolom yang akan dikembalikan, dipisahkan dengan koma.

wherestring

Ekspresi filter. Identifier kolom berikut dikenali (ini berbeda dari identifier yang dikenali oleh parameter select).

report_idstring

ID laporan yang akan digunakan. Jika ID diberikan, parameter lainnya diambil dari laporan (brand, competitors, market, country, filters). Jika country atau filters disediakan, parameter tersebut akan menggantikan yang ada di laporan. Anda dapat menemukannya di URL laporan Brand Radar Anda di Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring

Daftar merek yang akan dicari, dipisahkan dengan koma. Setidaknya salah satu dari brand, competitors, market, atau where tidak boleh kosong.

competitorsstring

Daftar pesaing merek Anda, dipisahkan dengan koma.

data_sourcestringWajib

Daftar model chatbot yang dipisahkan koma. Semua model bisa dikombinasikan satu sama lain. Modul claude hanya mendukung prompt kustom.
Model google_ai_overviews_keywords dan google_ai_mode_keywords melaporkan visibilitas AI Overview / AI Mode yang diturunkan dari kueri penelusuran Google (kata kunci), bukan dari prompt.

Nilai yang diizinkan:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Daftar kode negara dua huruf yang dipisahkan koma (ISO 3166-1 alpha-2).

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…

promptsstring

Jenis prompt yang akan digunakan. Jika tidak ditentukan, keduanya akan digunakan. Prompt kustom mengharuskan report_id disertakan.

Nilai yang diizinkan:ahrefscustom

limitinteger

Jumlah hasil yang akan dikembalikan.

Default:1000

datestring (date)

Tanggal yang akan dicari dalam format YYYY-MM-DD.

date_comparedstring (date)

Tanggal untuk dibandingkan dengan date, dalam format YYYY-MM-DD. Harus benar-benar lebih awal daripada date. Jika diatur, laporan mencakup setiap prompt yang dijawab pada salah satu tanggal tersebut, dan kolom status melaporkan bagaimana masing-masing berubah di antara keduanya. Prompt yang hanya dijawab pada date_compared dilaporkan sebagai lost, dan kolom lainnya menjelaskan responsnya pada date_compared, karena tidak memiliki respons pada date.

search_volume_typestring

Laporan visibilitas AI beralih ke volume yang disesuaikan untuk AI. Ini memberikan estimasi permintaan yang lebih baik untuk respons AI di seluruh chatbot dan permukaan penelusuran AI. Perhitungannya dilakukan dengan menyesuaikan volume pencarian Google berdasarkan perkiraan penggunaan tiap platform AI dibandingkan dengan Google. Parameter ini akan dihentikan pada 30 September 2026; semua permintaan akan menggunakan volume yang disesuaikan untuk AI yang baru.

Nilai yang diizinkan:ask_volumekeyword_volume

Default:ask_volume

order_bystring

Kolom untuk mengurutkan hasil.

Nilai yang diizinkan:relevancevolume

Default:relevance

outputstring

Format output.

Nilai yang diizinkan:jsonphp

Respons

ai_responsesarray<object>

countrystring

Negara dari pertanyaan tersebut.

data_sourcestring

Model chatbot yang menghasilkan respons.

last_updatedstring (date)

Tanggal saat data terakhir kali diperbarui.

linksarray<object>

(10 unit) Tautan yang digunakan untuk respons.

urlstring

titlestring or null

questionstring

Pertanyaan yang diajukan oleh pengguna.

responsestring

(10 unit) Respons dari model.

search_queriesarray<string>

Kueri pencarian yang digunakan chatbot untuk menemukan informasi untuk respons. Catatan: jika data_source tidak mencakup chatgpt atau perplexity, kolom ini akan selalu kosong.

statusstring or null

Bagaimana prompt berubah antara date_compared dan date. Null kecuali date_compared ditetapkan. new — dijawab pada date tetapi tidak pada date_compared. lost — dijawab pada date_compared tetapi tidak pada date; sisa baris ini menjelaskan respons date_compared, karena tidak ada respons pada date. no_change — dijawab pada kedua tanggal, yang tidak mengatakan apa pun tentang apakah respons itu sendiri, penyebutannya, atau kutipannya berubah.

Nilai yang diizinkan:newlostno_change

tagsarray<string>

Tag yang ditetapkan pada kueri.

volumeinteger

(10 unit) Perkiraan volume pencarian bulanan. Ini didasarkan pada perkiraan kami untuk Google, dengan menggabungkan volume pencarian kata kunci terkait di mana pertanyaan ini muncul di bagian People Also Ask.