Yapay Zekâ Yanıtları

API + MCP

GET/v3/brand-radar/ai-responses

Bu uç noktaya yapılan istekler, prompts parametresine göre API birimleri tüketir: yalnızca özel istem verisi döndüren istekler ücretsizdir; Ahrefs istem verisini içeren istekler ise standart API birim ücretlendirmesine tabidir.

Sorgu parametreleri

selectstringGerekli

Döndürülecek alanların virgülle ayrılmış listesi. Kullanılabilir alanlar: question, response, volume, country, links, search_queries, tags, data_source, last_updated.

wherestring

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları tanınır (bu, select parametresinin tanıdığı tanımlayıcılardan farklıdır).

cited_domain: Yanıtın oluşturulmasında kullanılan bir sayfanın alan adı.
tür: domain

cited_domain_subdomains: Yanıtın oluşturulmasında kullanılan bir sayfanın alan adı. Verilen alan adının herhangi bir alt alan adı da eşleşir.
tür: string

cited_url_exact: Yanıtın oluşturulmasında kullanılan bir sayfanın URL’si.
tür: string

cited_url_prefix: Yanıtın oluşturulmasında kullanılan bir sayfanın URL’si. Bu önekle başlayan herhangi bir URL eşleşir.
tür: string

question: Kullanıcının sorduğu soru.
tür: string

response (10 birim): Modelin yanıtı.
tür: string

search_queries: Chatbot’un yanıt için bilgi bulmak üzere kullandığı arama sorgusu. Not: data_source içinde chatgpt veya perplexity yoksa bu alan her zaman boş olur.
tür: string

topic: Sorgunun konusu.
tür: string

limitinteger

Döndürülecek sonuç sayısı.

Varsayılan:1000

datestring (date)

YYYY-AA-GG biçiminde aranacak tarih.

countrystring

İki harfli ülke kodlarının (ISO 3166-1 alpha-2) virgülle ayrılmış listesi.

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

order_bystring

Sonuçların sıralanacağı sütun.

İzin verilen değerler:relevancevolume

Varsayılan:relevance

report_idstring

Kullanılacak raporun kimliği. Bir rapor verilirse diğer parametreler rapordan alınır (marka, rakipler, pazar, ülke, filtreler). Ülke veya filtreler sağlanırsa rapordakilerin yerine geçer. Ahrefs’teki Brand Radar raporunuzun URL’sinde bulabilirsiniz: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Kullanılacak istem türü. Belirtilmezse her ikisi de kullanılır. Özel istemler için report_id sağlanmalıdır.

İzin verilen değerler:ahrefscustom

data_sourcestringGerekli

Virgülle ayrılmış bir sohbet botu modeli listesi. Google anahtar kelime modelleri (google_ai_overviews_keywords, google_ai_mode_keywords) birbirleriyle veya diğer modellerle birlikte kullanılamaz.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Markalarınızın niş pazarlarının virgülle ayrılmış bir listesi. 2026-05-18 tarihinde kullanımdan kaldırılmıştır; bu parametre bu tarihten kısa bir süre sonra etkisiz olacaktır.

competitorsstring

Markalarınızın rakiplerinin virgülle ayrılmış listesi.

brandstring

Aranacak markaların virgülle ayrılmış listesi. Brand, competitors, market veya where parametrelerinden en az biri boş olmamalıdır.

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

ai_responsesarray<object>

countrystring

Sorunun ülkesi.

data_sourcestring

Yanıtı üreten sohbet botu modeli.

last_updatedstring (date)

Verilerin en son güncellendiği tarih.

linksarray<object>

(10 birim) Yanıt için kullanılan bağlantılar.

urlstring

titlestring or null

questionstring

Kullanıcının sorduğu soru.

responsestring

(10 birim) Modelin yanıtı.

search_queriesarray<string>

Sohbet botunun yanıt için bilgi bulmak üzere kullandığı arama sorgusu. Not: data_source içinde chatgpt veya perplexity yoksa bu alan her zaman boş olur.

tagsarray<string>

Sorguya atanan etiketler.

volumeinteger

(10 birim) Tahmini aylık arama hacmi. Bu değer, Google için yaptığımız tahminlere dayanır ve bu sorunun "People Also Ask" bölümünde göründüğü ilgili anahtar kelimelerin arama hacimlerinin birleştirilmesiyle hesaplanır.