Genel bakış geçmişi - Söz Payı

API + MCP

GET/v3/brand-radar/sov-history

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

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ı 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

date_tostring

YYYY-MM-DD biçiminde, geçmiş döneminin bitiş tarihi.

date_fromstringGerekli

YYYY-MM-DD biçiminde, geçmiş döneminin başlangıç tarihi.

countrystring

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

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

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

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

İzin verilen değerler:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

Example:chatgpt,perplexity

marketstring

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

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

metricsarray<object>

datestring

share_of_voicearray<object>

(Her marka için 1 birim) Marka için tahmini ses payı.