Yapay Zekâ Yanıtları

API + MCP

POST/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.

İstek gövdesi

selectarray<string>Required

Döndürülecek sütunların listesi. Geçerli sütun tanımlayıcıları için yanıt şemasına bakın.

Example:["field_a","field_b"]

whereobject

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ı oluşturmak için kullanılan bir sayfanın alan adı.
tür: alan adı

cited_domain_subdomains: Yanıtı oluşturmak için kullanılan bir sayfanın alan adı. Verilen alan adının herhangi bir alt alan adı da eşleşir.
tür: dize

cited_url_exact: Yanıtı oluşturmak için kullanılan bir sayfanın URL’si.
tür: dize

cited_url_prefix: Yanıtı oluşturmak için kullanılan bir sayfanın URL’si. Bu önekle başlayan herhangi bir URL eşleşir.
tür: dize

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

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

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

topic: Sorgunun konusu.
tür: dize

tags_filterobject

İstem etiketleri için bir filtre ifadesi. report_id gerektirir. Aşağıdaki kısıtlamalarla birlikte filtre söz dizimini kullanır: tek geçerli alan adı "tag"'dir; tek geçerli operatörler şunlardır: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; and ve or için maksimum iç içe geçme derinliği 2'dir. Örnek: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

limitinteger

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

Default:1000

datestring

YYYY-AA-GG biçiminde aranacak tarih.

countryarray<string>

İki harfli ülke kodlarının (ISO 3166-1 alfa-2) listesi.

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

order_bystring

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

Allowed values:relevancevolume

Default: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.

Allowed values:ahrefscustom

data_sourcearray<string>Required

Chatbot modellerinin listesi. Google modelleri (google_ai_overviews, google_ai_mode) birbirleriyle veya Google dışı modellerle birlikte kullanılamaz.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

marketarray<string>

Markalarınızın niş pazarlarının listesi.

competitorsarray<object>

Aranacak rakip adları ve web sitelerinin listesi.

At least one of names or url_groups is required

namesarray<string>

Marka/rakibin adları

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstringrequired

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

At least one of names or url_groups is required

namesarray<string>

Marka/rakibin adları

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstringrequired

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

outputstring

Çıktı formatı.

Allowed values:jsonphp

Yanıtlar

ai_responsesarray<object>

countrystring

Sorunun ülkesi.

data_sourcestring

Yanıtı üreten sohbet botu modeli.

linksarray<object>

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

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.