AI 응답

API + MCP

GET/v3/brand-radar/ai-responses

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

쿼리 매개변수

date_comparedstring (date)

date와 비교할 날짜로, YYYY-MM-DD 형식입니다. date보다 반드시 더 이전이어야 합니다. 설정하면 보고서는 두 날짜 중 어느 날짜에든 답변된 모든 프롬프트를 포함하며, status 필드는 각 프롬프트가 두 날짜 사이에서 어떻게 변경됐는지를 보고합니다. date_compared에만 답변이 있고 date에는 없는 프롬프트는 lost로 보고되며, date에는 응답이 없으므로 나머지 필드는 date_compared의 응답을 설명합니다.

selectstring필수

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

wherestring

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

limitinteger

반환할 결과 수입니다.

기본:1000

datestring (date)

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

search_volume_typestring

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

허용되는 값:ask_volumekeyword_volume

기본:ask_volume

countrystring

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

허용되는 값:adaeafagaialamaoarasatauawazba…

order_bystring

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

허용되는 값:relevancevolume

기본:relevance

report_idstring

사용할 보고서의 ID입니다. 지정하면 다른 파라미터(brand, competitors, market, country, filters)는 보고서에서 가져옵니다. 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에 더 이상 사용되지 않으며, 해당 날짜 이후 곧 이 파라미터는 효과가 없어집니다.

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가 포함되지 않으면 이 필드는 항상 비어 있습니다.

statusstring or null

date_compared와 date 사이에서 프롬프트가 어떻게 변경됐는지입니다. date_compared가 설정되지 않으면 null입니다. new — date에는 답변이 있지만 date_compared에는 없습니다. lost — date_compared에는 답변이 있지만 date에는 없습니다. date에는 응답이 없으므로 이 행의 나머지는 date_compared의 응답을 설명합니다. no_change — 두 날짜 모두에 답변이 있습니다. 이는 응답 자체, 언급, 인용이 변경됐는지 여부와는 무관합니다.

허용되는 값:newlostno_change

tagsarray<string>

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

volumeinteger

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