Laporan Brand Radar

Hanya API

POST/v3/management/brand-radar-reports

Permintaan ke endpoint ini gratis dan tidak menghabiskan unit API.

Parameter kueri

outputstring

Format output.

Nilai yang diizinkan:jsonphp

Isi permintaan

prompts_frequencyarray<object>

Frekuensi prompt yang akan digunakan.

data_sourcestringrequired

Sumber data yang akan digunakan.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity

frequencystringrequired

Interval pembaruan yang akan digunakan.

Allowed values:dailyweeklymonthlyoff

project_idinteger

ID Proyek yang akan digunakan.

namestring

Nama laporan.

marketarray<string>

Daftar pasar niche merek Anda. Tidak digunakan lagi sejak 2026-05-18, parameter ini tidak akan berpengaruh segera setelah tanggal tersebut.

competitors

Setidaknya salah satu dari brand, competitors, atau market wajib tidak kosong.

Direkomendasikan. Dapat menentukan nama merek dan grup URL untuk penargetan yang lebih presisi.

At least one of names or url_groups is required

namesarray<string>

Nama merek/kompetitor

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

url_groupsarray<object>

targetstring (domain)required

Domain target

Example:ahrefs.com

scopestringrequired

Cakupan target.

Allowed values:urlpathdomainsubdomains

brand

Setidaknya salah satu dari brand, competitors, atau market wajib tidak kosong.

Direkomendasikan. Dapat menentukan nama merek dan grup URL untuk penargetan yang lebih presisi.

At least one of names or url_groups is required

namesarray<string>

Nama merek/kompetitor

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

url_groupsarray<object>

targetstring (domain)required

Domain target

Example:ahrefs.com

scopestringrequired

Cakupan target.

Allowed values:urlpathdomainsubdomains

Respons

reportsarray<object>

created_atstring (date)

Tanggal laporan dibuat.

project_idinteger or null

ID Proyek yang ditautkan dengan laporan.

prompts_frequencyarray<object>

Catatan dengan kolom data_source (nilai yang mungkin: chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) dan frequency (nilai yang mungkin: daily, weekly, monthly, off).

data_sourcestring

frequencystring

report_idstring

Pengenal unik laporan.

report_namestring

Nama laporan.

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