Genel bakış - Bahsetmeler

API + MCP

POST/v3/brand-radar/mentions-overview

Bu uç noktaya yapılan istekler, prompts parametresine bağlı olarak API birimi harcar: yalnızca özel istem verilerini döndüren istekler ücretsizdir; Ahrefs istem verilerini içeren istekler ise standart API birimi fiyatlandırmasına tabidir.

brands içinde (ve geçerliyse competitors içinde) sağlanan her varlık, names içinde en az bir değer içermelidir. Yalnızca url_groups’tan oluşan varlıklar burada desteklenmez; çünkü bahsedilmeler marka adlarıyla eşleştirilir.

İstek gövdesi

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).

selectarray<string>Required

Döndürülecek alanların bir listesi.

Example:["field_a","field_b"]

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"]}]}.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

Default:

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

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.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

marketarray<string>

Markalarınızın niş pazarlarının 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.

competitorsarray<object>

Aranacak rakip adları ve web sitelerinin listesi.

Default:

At least one of names or url_groups is required

namesarray<string>

Marka/rakibin adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

Default:

At least one of names or url_groups is required

namesarray<string>

Marka/rakibin adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

outputstring

Çıktı formatı.

Allowed values:jsoncsvxmlphp

Yanıtlar

metricsarray<object>

brandstring

Marka adı (kendi markanız veya istekte belirtilen bir rakip).

no_tracked_brandsinteger

Belirtilen pazarla ilgili yanıtlardan, sağlanan markaların hiçbirinden bahsetmeyenlerin tahmini bahsedilme sayısı (market belirtilmediğinde değer sıfırdır).

only_competitors_brandsinteger

Yalnızca rakip markalardan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

only_target_brandinteger

Yalnızca kendi markanızdan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

target_and_competitors_brandsinteger

Hem kendi markanızdan hem de rakip markalardan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

totalinteger

Markanız için toplam tahmini bahsedilme sayısı (only_target_brand ve target_and_competitors_brands dahil).

curl "https://api.ahrefs.com/v3/brand-radar/mentions-overview" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "where": {}, "select": ["field_a","field_b"], "tags_filter": {}, "country": ["ad"], "report_id": "string", "prompts": "ahrefs", "data_source": ["chatgpt"], "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "brands": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "output": "json" }'

{ "metrics": [ { "brand": "string", "no_tracked_brands": 0, "only_competitors_brands": 0, "only_target_brand": 0, "target_and_competitors_brands": 0, "total": 0 } ] }