Docs
Dokümanlarda ara...⌘K

Brand Radar raporları ekle

API + MCP
POST/v3/management/brand-radar-reports

Bu uç noktaya yapılan istekler ücretsizdir ve herhangi bir API birimi tüketmez.

Sorgu parametreleri

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

İstek gövdesi

brand

brand veya competitors alanlarından en az birinin boş olmaması gerekir.

Önerilir. Hassas hedefleme için marka adlarını ve URL gruplarını belirtebilirsiniz.

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
competitors

brand veya competitors alanlarından en az birinin boş olmaması gerekir.

Önerilir. Hassas hedefleme için marka adlarını ve URL gruplarını belirtebilirsiniz.

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
namestring

Raporun adı.

project_idinteger

Kullanılacak proje kimliği.

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.

prompts_frequencyarray<object>

Kullanılacak istem sıklığı.

Min.:1
data_sourcestringrequired

Kullanılacak veri kaynağı.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrok
frequencystringrequired

Kullanılacak güncelleme aralığı.

İzin verilen değerler:dailyweeklymonthlyoff

Yanıtlar

reportsarray<object>
created_atstring (date)

Raporun oluşturulduğu tarih.

project_idinteger or null

Raporun bağlı olduğu proje kimliği.

prompts_frequencyarray<object>

data_source (olası değerler: chatgpt, copilot, gemini, google_ai_mode, claude, google_ai_overviews, grok, perplexity) ve frequency (olası değerler: daily, weekly, monthly, off) alanlarına sahip bir kayıt.

data_sourcestring
frequencystring
report_idstring

Raporun benzersiz tanımlayıcısı.

report_namestring

Raporun adı.