Raporty Brand Radar

Tylko API

POST/v3/management/brand-radar-reports

Żądania do tego punktu końcowego są bezpłatne i nie zużywają żadnych jednostek API.

Parametry zapytania

outputstring

Format wyjściowy.

Dozwolone wartości:jsonphp

Treść żądania

prompts_frequencyarray<object>

Częstotliwość promptów do użycia.

data_sourcestringrequired

Źródło danych do użycia.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity

frequencystringrequired

Interwał aktualizacji do użycia.

Allowed values:dailyweeklymonthlyoff

project_idinteger

Identyfikator projektu do użycia.

namestring

Nazwa raportu.

marketarray<string>

Lista rynków niszowych Twoich marek. Wycofane od 2026-05-18; krótko po tej dacie ten parametr przestanie działać.

competitors

Co najmniej jedno z pól brand, competitors lub market musi być niepuste.

Zalecane. Umożliwia podanie nazw marek i grup adresów URL w celu precyzyjnego targetowania.

At least one of names or url_groups is required

namesarray<string>

Nazwy marki/konkurenta

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

url_groupsarray<object>

targetstring (domain)required

Domena celu

Example:ahrefs.com

scopestringrequired

Zakres celu.

Allowed values:urlpathdomainsubdomains

brand

Co najmniej jedno z pól brand, competitors lub market musi być niepuste.

Zalecane. Umożliwia podanie nazw marek i grup adresów URL w celu precyzyjnego targetowania.

At least one of names or url_groups is required

namesarray<string>

Nazwy marki/konkurenta

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

url_groupsarray<object>

targetstring (domain)required

Domena celu

Example:ahrefs.com

scopestringrequired

Zakres celu.

Allowed values:urlpathdomainsubdomains

Odpowiedzi

reportsarray<object>

created_atstring (date)

Data utworzenia raportu.

project_idinteger or null

Identyfikator projektu, z którym powiązany jest raport.

prompts_frequencyarray<object>

Rekord z polami data_source (możliwe wartości: chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) oraz frequency (możliwe wartości: daily, weekly, monthly, off).

data_sourcestring

frequencystring

report_idstring

Unikatowy identyfikator raportu.

report_namestring

Nazwa raportu.

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