Docs
문서 검색...⌘K

개요 - 노출수

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

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

요청 본문

selectarray<string>Required

반환할 필드 목록입니다.

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

필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 파라미터에서 인식되는 식별자와 다릅니다).

report_idstring

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

brandsarray<object>

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

Default:[]
At least one of names or url_groups is required
namesarray<string>

The names of the brand/competitor

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

The domain of the target

Example:ahrefs.com
scopestringrequired

Scope of the target.

허용되는 값:urlpathdomainsubdomains
competitorsarray<object>

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

Default:[]
At least one of names or url_groups is required
namesarray<string>

The names of the brand/competitor

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

The domain of the target

Example:ahrefs.com
scopestringrequired

Scope of the target.

허용되는 값:urlpathdomainsubdomains
data_sourcearray<string>Required

챗봇 모델 목록입니다. 모든 모델은 서로 함께 사용할 수 있습니다. claude 모듈은 사용자 정의 프롬프트만 지원합니다.
google_ai_overviews_keywords 및 google_ai_mode_keywords 모델은 프롬프트가 아닌 Google 검색 쿼리(키워드)에서 도출된 AI 개요/AI 모드 가시성을 보고합니다.

허용되는 값:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
countryarray<string>

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

허용되는 값:adaeafagaialamaoarasatauawazba…
Default:[]
promptsstring

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

허용되는 값:ahrefscustom
search_volume_typestring

AI 가시성 보고서는 AI 조정 검색량으로 전환 중입니다. 이는 챗봇과 AI 검색 지면 전반에서 AI 응답에 대한 수요를 더 정확하게 추정합니다. 각 AI 플랫폼의 추정 사용량을 Google과 비교해 Google 검색량을 조정하여 계산합니다. 이 파라미터는 2026년 9월 30일에 더 이상 사용되지 않을 예정이며, 이후 모든 요청은 새로운 AI 조정 검색량을 사용합니다.

허용되는 값:ask_volumekeyword_volume
Default:ask_volume
tags_filterobject

프롬프트 태그에 대한 필터 표현식입니다. report_id가 필요합니다. 다음 제한 사항이 적용되는 필터 문법을 사용합니다: 유효한 필드 이름은 "tag"뿐입니다. 유효한 연산자는 다음뿐입니다: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty". and와 or의 최대 중첩 깊이는 2입니다.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
outputstring

출력 형식입니다.

허용되는 값: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 포함).