Docs
문서 검색...⌘K

인용된 페이지

API + MCP
POST/v3/brand-radar/cited-pages

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

요청 본문

brand_filterobject

브랜드 가시성에 대한 필터 표현식으로, “내 브랜드” 필터와 동일하게 동작합니다. brand_name은 응답에서 브랜드가 언급되었는지 여부를 매칭합니다: "mentioned" 또는 "not_mentioned". page_status는 AI가 페이지를 사용한 방식을 매칭합니다: "cited"(AI가 사이트의 페이지를 가져와 답변에서 참조함), "found_but_not_cited"(AI가 사이트의 페이지를 잠재적 출처로 가져왔지만 최종 답변에서는 참조하지 않음), 또는 "not_found"(AI가 사이트에서 페이지를 전혀 가져오지 않음).
다음 제한 사항이 적용되는 필터 문법을 사용합니다: 유효한 연산자는 "eq"뿐입니다. 각 필드는 하나의 섹션입니다. 단일 값을 지정하거나 같은 필드의 여러 값을 or로 결합하세요. brand_name과 page_status 섹션은 최상위 and/or로 연결하세요. 필드의 모든 값을 선택하면 모든 항목과 일치하므로 거부됩니다(대신 해당 필드를 생략하세요).

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}
volume_rangeobject

필터링에 사용할 검색량 범위입니다.

frominteger
tointeger
selectarray<string>Required

반환할 필드 목록입니다.

사용 가능한 필드:
  • responses
  • url
Example:["field_a","field_b"]
whereobject

필터 식입니다. 다음 열 식별자를 사용할 수 있습니다(이는 select 매개변수에서 사용할 수 있는 식별자와 다릅니다).

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

반환할 결과 수입니다.

Default:1000
datestring (date)

YYYY-MM-DD 형식으로 검색할 날짜입니다.

search_volume_typestring

AI 가시성 보고서가 AI 조정 검색량으로 전환됩니다. 이를 통해 챗봇과 AI 검색 노출면 전반에서 AI 응답에 대한 수요를 더 정확하게 추정할 수 있습니다. 이 값은 각 AI 플랫폼의 추정 사용량을 Google과 비교해, 플랫폼별로 Google 검색량을 조정하여 산출합니다. 이 매개변수는 2026년 8월 31일에 폐기 예정이며, 이후 모든 요청은 새로운 AI 조정 검색량을 사용합니다.

허용되는 값:ask_volumekeyword_volume
Default:ask_volume
countryarray<string>

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

허용되는 값:adaeafagaialamaoarasatauawazba…
Default:[]
tracked_urlsarray<string>

추적 중인 페이지 URL 목록입니다. 제공하면 데이터가 없는 추적 URL에 대해서도 인용 수가 0인 행이 응답에 포함됩니다.

report_idstring

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

promptsstring

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

허용되는 값:ahrefscustom
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
marketarray<string>

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

competitorsarray<object>

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

Default:[]
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

대상의 범위입니다.

허용되는 값:urlpathdomainsubdomains
brandsarray<object>

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

Default:[]
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

대상의 범위입니다.

허용되는 값:urlpathdomainsubdomains
outputstring

출력 형식입니다.

허용되는 값:jsonphp

응답

pagesarray<object>
mentionsarray<object>

2026-02-10에 사용 중단되었습니다.

responsesinteger

해당 페이지를 인용한 응답 수입니다.

urlstring

인용된 페이지의 URL입니다.

volumeinteger

2026-03-24에 사용 중단되었습니다.