Docs
문서 검색...⌘K

인용된 페이지

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

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

요청 본문

selectarray<string>Required

반환할 열 목록입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.

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

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

cited_domain: 응답을 생성하는 데 사용된 페이지의 도메인입니다.
type: domain

cited_domain_subdomains: 응답을 생성하는 데 사용된 페이지의 도메인입니다. 지정한 도메인의 모든 하위 도메인도 일치합니다.
type: string

cited_url_exact: 응답을 생성하는 데 사용된 페이지의 URL입니다.
type: string

cited_url_prefix: 응답을 생성하는 데 사용된 페이지의 URL입니다. 이 접두사로 시작하는 모든 URL이 일치합니다.
type: string

question: 사용자가 한 질문입니다.
type: string

response (10 units): 모델의 응답입니다.
type: string

search_queries: 챗봇이 응답에 대한 정보를 찾기 위해 사용한 검색어입니다. 참고: data_sourcechatgpt 또는 perplexity가 포함되지 않으면 이 필드는 항상 비어 있습니다.
type: string

topic: 쿼리의 주제입니다.
type: string

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

limitinteger

반환할 결과 수입니다.

Default:1000
datestring

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

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
tracked_urlsarray<string>

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

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, google_ai_mode)은 서로 또는 Google 이외 모델과 함께 사용할 수 없습니다.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
marketarray<string>

브랜드의 틈새 시장 목록입니다.

competitorsarray<object>

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

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

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

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

대상의 도메인입니다.

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>
targetstringrequired

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

Allowed values:urlpathdomainsubdomains
outputstring

출력 형식입니다.

Allowed values:jsonphp

응답

pagesarray<object>
mentionsarray<object>

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

responsesinteger

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

urlstring

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

volumeinteger

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