Docs
문서 검색...⌘K

인용 기록 개요

API + MCP
POST/v3/brand-radar/citations-history

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

brands(해당되는 경우 competitors 포함)에 제공되는 각 엔터티에는 url_groups에 값이 하나 이상 포함되어야 합니다. 인용은 URL 그룹을 기준으로 매칭되므로, names만으로 구성된 엔터티는 이 엔드포인트에서 지원되지 않습니다.

요청 본문

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"]}]}
date_tostring (date)

YYYY-MM-DD 형식의 이력 기간 종료일.

date_fromstring (date)Required

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

사용할 보고서의 ID입니다. 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)되었으며, 이 날짜 이후 곧 이 매개변수는 효력을 잃게 됩니다.

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

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

metricsarray<object>
citationsinteger

브랜드 URL을 언급한 응답으로부터 추정한 인용 수입니다.

datestring (date)