Brand Radar Raporları

Yalnızca API

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

prompts_frequencyarray<object>

Kullanılacak istem sıklığı.

data_sourcestringrequired

Kullanılacak veri kaynağı.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity

frequencystringrequired

Kullanılacak güncelleme aralığı.

Allowed values:dailyweeklymonthlyoff

project_idinteger

Kullanılacak proje kimliği.

namestring

Raporun adı.

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.

competitors

brand, competitors veya market alanlarından en az biri boş olmamalıdır.

Ö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/rakibin adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

brand

brand, competitors veya market alanlarından en az biri boş olmamalıdır.

Ö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/rakibin adları

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

url_groupsarray<object>

targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com

scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains

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, google_ai_overviews, grok, perplexity) ve frequency (olası değerler: daily, weekly, monthly, off) alanlarını içeren bir kayıt.

data_sourcestring

frequencystring

report_idstring

Raporun benzersiz tanımlayıcısı.

report_namestring

Raporun adı.

curl "https://api.ahrefs.com/v3/management/brand-radar-reports" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "prompts_frequency": [ { "data_source": "chatgpt", "frequency": "daily" } ], "project_id": 0, "name": "string", "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": null, "scope": null } ] } ], "brand": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": null, "scope": null } ] } ] }'

{ "reports": [ { "created_at": "string", "project_id": 0, "prompts_frequency": [ { "data_source": "string", "frequency": "string" } ], "report_id": "string", "report_name": "string" } ] }