Alıntılanan Sayfalar

API + MCP

POST/v3/brand-radar/cited-pages

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 alanların listesi.

Mevcut alanlar:

responses
title
url

Example:["field_a","field_b"]

whereobject

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

report_idstring

Kullanılacak raporun ID’si. 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. Bunu, Ahrefs’teki Brand Radar raporunuzun URL’sinde bulabilirsiniz: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Marka/rakip adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

İzin verilen değerler:urlpathdomainsubdomains

competitorsarray<object>

Aranacak rakip adları ve web sitelerinin listesi.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Marka/rakip adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

İzin verilen değerler:urlpathdomainsubdomains

content_filterobject

İçeriklerine göre sonuçları dahil etmek veya hariç tutmak için kullanılan isteğe bağlı ifadeler.

includearray<string>

Yalnızca bu tam ifadelerden en az birini içeren sonuçları göster.

excludearray<string>

Bu tam ifadelerden herhangi birini içeren sonuçları gizle.

data_sourcearray<string>Required

Sohbet botu modellerinin listesi. Tüm modeller birbiriyle birlikte kullanılabilir. claude modülü yalnızca özel istemleri destekler.
google_ai_overviews_keywords ve google_ai_mode_keywords modelleri, istemlerden ziyade Google arama sorgularından (anahtar kelimelerden) elde edilen AI Overviews / AI Mode görünürlüğünü raporlar.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

countryarray<string>

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

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

Default:[]

promptsstring

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

İzin verilen değerler:ahrefscustom

limitinteger

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

Default:1000

datestring (date)

YYYY-MM-DD biçiminde aranacak tarih.

tracked_urlsarray<string>

Takip edilen sayfa URL’lerinin listesi. Sağlandığında yanıt, veri olmayan takip edilen URL’ler için sıfır atıf içeren satırları da içerir.

Min.:1

tags_filterobject

İstem etiketleri için bir filtre ifadesi. report_id gereklidir. Şu kısıtlamalarla filtre söz dizimini kullanır: geçerli tek alan adı "tag"’dir; geçerli operatörler yalnızca ş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.

Example:{ "or": [ { "field": "tag", "is": [ "eq", "branded" ] }, { "field": "tag", "is": [ "eq", "competitor" ] } ] }

brand_filterobject

Markanızın görünürlüğüne yönelik, “Markanız” filtresini yansıtan bir filtre ifadesi. brand_name, bir yanıtın markanızdan bahsedip bahsetmediğine göre eşleşir: "mentioned" veya "not_mentioned". page_status, yapay zekânın sayfalarınızı nasıl kullandığına göre eşleşir: "cited" (yapay zekâ sitenizdeki sayfalara erişti ve yanıtta bunlara atıfta bulundu), "found_but_not_cited" (yapay zekâ sitenizdeki sayfalara olası kaynaklar olarak erişti ancak nihai yanıtta bunlara atıfta bulunmadı) veya "not_found" (yapay zekâ sitenizdeki hiçbir sayfaya erişmedi).
Şu kısıtlamalarla filtre söz dizimini kullanır: geçerli tek operatör "eq"’dir; her alan ayrı bir bölümdür: tek bir değer verin veya aynı alanın birden fazla değerini or ile birleştirin; brand_name ve page_status bölümlerini en üst düzeyde bir and/or ile birleştirin. Bir alanın tüm değerlerini seçmek, her şeyle eşleşeceği için kabul edilmez (bunun yerine alanı tamamen atlayın).

Example:{ "and": [ { "field": "brand_name", "is": [ "eq", "mentioned" ] }, { "or": [ { "field": "page_status", "is": [ "eq", "cited" ] }, { "field": "page_status", "is": [ "eq", "found_but_not_cited" ] } ] } ] }

volume_rangeobject

Filtreleme için kullanılacak hacim aralığı.

frominteger

tointeger

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

pagesarray<object>

mentionsarray<object>

2026-02-10 tarihinde kullanımdan kaldırıldı.

responsesinteger

Sayfayı kaynak gösteren yanıt sayısı.

titlestring or null

Yapay zekâ yanıtı alıntısında gösterilen sayfa başlığı veya hiçbir yanıt böyle bir başlık kaydetmediyse taranan sayfanın başlığı. İkisi de bilinmiyorsa null.

urlstring

Kaynak gösterilen sayfanın URL’si.

volumeinteger

2026-03-24 tarihinde kullanımdan kaldırıldı.