AI 응답

API + MCP

GET/v3/brand-radar/ai-responses

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

쿼리 매개변수

selectstring필수

반환할 필드의 쉼표로 구분된 목록입니다.

wherestring

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

limitinteger

반환할 결과 수입니다.

기본:1000

datestring (date)

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

search_volume_typestring

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

허용되는 값:ask_volumekeyword_volume

기본:ask_volume

countrystring

두 글자 국가 코드(ISO 3166-1 alpha-2)를 쉼표로 구분한 목록입니다.

허용되는 값:adaeafagaialamaoarasatauawazba…

order_bystring

결과를 정렬할 기준 열입니다.

허용되는 값:relevancevolume

기본:relevance

report_idstring

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

promptsstring

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

허용되는 값:ahrefscustom

data_sourcestring필수

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

허용되는 값:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

브랜드의 틈새 시장을 쉼표로 구분해 나열한 목록입니다. 2026-05-18에 사용 중단(Deprecated)되며, 이 날짜 이후 얼마 지나지 않아 이 매개변수는 더 이상 영향을 미치지 않습니다.

competitorsstring

브랜드 경쟁사를 쉼표로 구분해 나열한 목록입니다.

brandstring

검색할 브랜드를 쉼표로 구분해 나열한 목록입니다. brand, competitors, market, where 중 최소 하나는 비어 있으면 안 됩니다.

outputstring

출력 형식입니다.

허용되는 값:jsonphp

응답

ai_responsesarray<object>

countrystring

질문의 국가입니다.

data_sourcestring

응답을 생성한 챗봇 모델입니다.

last_updatedstring (date)

데이터가 마지막으로 업데이트된 날짜입니다.

linksarray<object>

(10 유닛) 응답에 사용된 링크입니다.

urlstring

titlestring or null

questionstring

사용자가 한 질문입니다.

responsestring

(10 단위) 모델의 응답입니다.

search_queriesarray<string>

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

tagsarray<string>

쿼리에 할당된 태그입니다.

volumeinteger

(10 단위) 추정 월간 검색량입니다. 이는 Google에 대한 당사 추정치에 기반하며, 이 질문이 People Also Ask 섹션에 표시되는 관련 키워드의 검색량을 합산해 산출합니다.