Docs
문서 검색...⌘K

개요 - 언급

API + MCP
POST/v3/brand-radar/mentions-overview

Requests to this endpoint consume API units based on the prompts parameter: requests returning only custom prompt data are free, while requests including Ahrefs prompt data follow standard API unit pricing.

Every entity provided in brands (and competitors, when applicable) must include at least one value in names. Entities consisting only of url_groups are not supported here because mentions are matched against brand names.

요청 본문

whereobject

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

selectarray<string>Required

반환할 필드 목록입니다.

Example:["field_a","field_b"]
tags_filterobject

프롬프트 태그에 대한 필터 표현식입니다. report_id가 필요합니다. 다음 제한 사항과 함께 필터 문법을 사용합니다: 유효한 필드 이름은 "tag"뿐이며, 유효한 연산자는 "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"뿐입니다. and, or의 최대 중첩 깊이는 2입니다. 예: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

countryarray<string>

두 글자 국가 코드(ISO 3166-1 alpha-2) 목록입니다.

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

사용할 보고서의 ID입니다. 값을 지정하면 다른 매개변수(브랜드, 경쟁사, 시장, 국가, 필터)는 보고서에서 가져옵니다. 국가 또는 필터를 제공하면 보고서의 값을 덮어씁니다. Ahrefs의 브랜드 레이더 보고서 URL에서 확인할 수 있습니다: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

챗봇 모델 목록입니다. Google 키워드 모델(google_ai_overviews_keywords, google_ai_mode_keywords)은 서로 간에 또는 다른 모델과 함께 사용할 수 없습니다.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

브랜드의 틈새 시장 목록입니다. 2026-05-18에 사용 중단(Deprecated)되었으며, 이 날짜 이후 곧 이 매개변수는 효력을 잃게 됩니다.

competitorsarray<object>

검색할 경쟁사 이름과 웹사이트 목록입니다.

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

브랜드/경쟁사의 이름입니다.

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

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

검색할 브랜드 이름과 웹사이트 목록입니다.

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

브랜드/경쟁사의 이름입니다.

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

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

Allowed values:urlpathdomainsubdomains
outputstring

출력 형식입니다.

Allowed values:jsoncsvxmlphp

응답

metricsarray<object>
brandstring

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

no_tracked_brandsinteger

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

only_competitors_brandsinteger

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

only_target_brandinteger

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

target_and_competitors_brandsinteger

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

totalinteger

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