Docs
Dokumentation durchsuchen...⌘K

Brand Radar Reports

Nur API
POST/v3/management/brand-radar-reports

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Anfrage-Body

prompts_frequencyarray<object>

Die zu verwendende Prompt-Frequenz.

data_sourcestringrequired

Die zu verwendende Datenquelle.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity
frequencystringrequired

Das zu verwendende Aktualisierungsintervall.

Allowed values:dailyweeklymonthlyoff
project_idinteger

Die ID des zu verwendenden Projekts.

namestring

Der Name des Reports.

marketarray<string>

Eine Liste der Nischenmärkte Ihrer Marken. Veraltet ab dem 2026-05-18; dieser Parameter wird kurz nach diesem Datum keine Wirkung mehr haben.

competitors

Mindestens eines von brand, competitors oder market muss nicht leer sein.

Empfohlen. Ermöglicht die Angabe von Markennamen und URL-Gruppen für präzises Targeting.

At least one of names or url_groups is required
namesarray<string>

Die Namen der Marke/des Wettbewerbers

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Die Domain des Ziels

Example:ahrefs.com
scopestringrequired

Geltungsbereich des Ziels.

Allowed values:urlpathdomainsubdomains
brand

Mindestens eines von brand, competitors oder market muss nicht leer sein.

Empfohlen. Ermöglicht die Angabe von Markennamen und URL-Gruppen für präzises Targeting.

At least one of names or url_groups is required
namesarray<string>

Die Namen der Marke/des Wettbewerbers

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Die Domain des Ziels

Example:ahrefs.com
scopestringrequired

Geltungsbereich des Ziels.

Allowed values:urlpathdomainsubdomains

Antworten

reportsarray<object>
created_atstring (date)

Das Datum, an dem der Report erstellt wurde.

project_idinteger or null

Die ID des Projekts, mit dem der Report verknüpft ist.

prompts_frequencyarray<object>

Ein Datensatz mit den Feldern data_source (mögliche Werte: chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) und frequency (mögliche Werte: daily, weekly, monthly, off).

data_sourcestring
frequencystring
report_idstring

Der eindeutige Identifikator des Reports.

report_namestring

Der Name des Reports.