브랜드 레이더 보고서
API 전용POST/v3/management/brand-radar-reports
이 엔드포인트로의 요청은 무료이며 API 유닛을 소모하지 않습니다.
쿼리 매개변수
outputstring
출력 형식입니다.
허용되는 값:jsonphp
요청 본문
prompts_frequencyarray<object>
사용할 프롬프트 빈도입니다.
data_sourcestringrequired
사용할 데이터 소스입니다.
Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity
frequencystringrequired
사용할 업데이트 간격입니다.
Allowed values:dailyweeklymonthlyoff
project_idinteger
사용할 프로젝트의 ID입니다.
namestring
보고서 이름입니다.
marketarray<string>
브랜드의 틈새 시장 목록입니다. 2026-05-18에 사용 중단(Deprecated)되었으며, 이 날짜 이후 곧 이 매개변수는 효력을 잃게 됩니다.
competitors
brand, competitors, market 중 최소 하나는 비어 있지 않아야 합니다.
권장 사항입니다. 정확한 타기팅을 위해 브랜드명과 URL 그룹을 지정할 수 있습니다.
At least one of
names or url_groups is requirednamesarray<string>
브랜드/경쟁사의 이름입니다.
Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required
대상의 도메인입니다.
Example:ahrefs.com
scopestringrequired
대상의 범위입니다.
Allowed values:urlpathdomainsubdomains
brand
brand, competitors, market 중 최소 하나는 비어 있지 않아야 합니다.
권장 사항입니다. 정확한 타기팅을 위해 브랜드명과 URL 그룹을 지정할 수 있습니다.
At least one of
names or url_groups is requirednamesarray<string>
브랜드/경쟁사의 이름입니다.
Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required
대상의 도메인입니다.
Example:ahrefs.com
scopestringrequired
대상의 범위입니다.
Allowed values:urlpathdomainsubdomains
응답
reportsarray<object>
created_atstring (date)
보고서가 생성된 날짜입니다.
project_idinteger or null
보고서가 연결된 프로젝트의 ID입니다.
prompts_frequencyarray<object>
data_source(가능한 값: chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) 및 frequency(가능한 값: daily, weekly, monthly, off) 필드가 있는 레코드입니다.
data_sourcestring
frequencystring
report_idstring
보고서의 고유 식별자입니다.
report_namestring
보고서 이름입니다.
errorstring
errorstring
errorstring
errorstring
errorstring