언급

API + MCP

GET/v3/brand-radar/mentions-overview

이 엔드포인트로 보내는 요청은 prompts 매개변수에 따라 API 유닛을 소모합니다. 사용자 정의 프롬프트 데이터만 반환하는 요청은 무료이며, Ahrefs 프롬프트 데이터를 포함하는 요청에는 스탠다드 API 유닛 요금이 적용됩니다.

쿼리 매개변수

selectstring필수

반환할 필드의 쉼표로 구분된 목록입니다.

wherestring

필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 매개변수에서 인식되는 식별자와 다릅니다).

report_idstring

사용할 보고서의 ID입니다. ID가 제공되면 다른 파라미터(brand, competitors, market, country, filters)는 보고서에서 가져옵니다. country 또는 filters가 제공되면 보고서의 값을 덮어씁니다. Ahrefs의 브랜드 레이더 보고서 URL에서 확인할 수 있습니다: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring

검색할 브랜드의 쉼표로 구분된 목록입니다. brand, competitors, market, where 중 최소 하나는 비어 있으면 안 됩니다.

competitorsstring

브랜드 경쟁사의 쉼표로 구분된 목록입니다.

data_sourcestring필수

챗봇 모델을 쉼표로 구분해 나열한 목록입니다. 모든 모델은 서로 조합할 수 있습니다. claude 모듈은 사용자 정의 프롬프트만 지원합니다.
google_ai_overviews_keywords 및 google_ai_mode_keywords 모델은 프롬프트가 아니라 Google 검색 쿼리(키워드)에서 파생된 AI 개요/AI 모드 가시성을 보고합니다.

허용되는 값:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

두 글자 국가 코드(ISO 3166-1 alpha-2)의 쉼표로 구분된 목록입니다.

허용되는 값:adaeafagaialamaoarasatauawazba…

promptsstring

사용할 프롬프트 유형입니다. 지정하지 않으면 둘 다 사용됩니다. 사용자 정의 프롬프트를 사용하려면 report_id를 제공해야 합니다.

허용되는 값:ahrefscustom

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

metricsarray<object>

brandstring

브랜드명(요청에 포함된 자사 브랜드 또는 경쟁사)입니다.

entity_typestring

해당 행이 집계값, 타겟 브랜드 또는 경쟁사를 나타내는지 여부입니다.

허용되는 값:aggregatetargetcompetitor

no_tracked_brandsinteger

제공된 어떤 브랜드도 언급되지 않은, 지정된 시장과 관련된 응답에서의 추정 언급 수입니다(market이 지정되지 않으면 값은 0).

only_competitors_brandsinteger

경쟁사 브랜드만 언급한 응답에서의 추정 언급 수입니다.

only_target_brandinteger

자사 브랜드만 언급한 응답에서의 추정 언급 수입니다.

target_and_competitors_brandsinteger

자사와 경쟁사 브랜드를 모두 언급한 응답에서의 추정 언급 수입니다.

totalinteger

자사 브랜드의 총 추정 언급 수입니다(only_target_brand 및 target_and_competitors_brands 포함).