ai-search/
llm-brand-metrics

Google AI 개요나 ChatGPT 답변 중 몇 개가 도메인이나 키워드를 언급하는지 세고, 해당 답변의 AI 검색량 합계, 가장 많이 인용된 도메인, 함께 등장한 브랜드를 반환합니다.

AI Search Visibility API

AI 점유율
인용된 도메인
함께 언급된 브랜드
AI 개요와 ChatGPT
요청당 40 크레딧 + 결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

AI Search Visibility

AI 검색 노출이란 AI가 생성한 답변에서 브랜드가 얼마나 다뤄지는지를 뜻하며, Google AI 개요나 ChatGPT 답변 중 몇 개가 브랜드를 언급하거나 인용하는지, 그 질문들 뒤에 매달 얼마만큼의 검색 수요가 있는지, 답변이 어떤 사이트를 근거로 삼는지, 같은 답변에 어떤 브랜드가 함께 나오는지로 나타납니다. 자사와 경쟁사를 나란히 측정하면 한 카테고리에서 AI가 누구를 추천하는지, 그 추천을 좌우하는 매체가 어디인지, 콘텐츠나 PR 작업 뒤에 노출이 늘었는지 알 수 있습니다.

AI Search Visibility API 주요 기능

  • 전체 노출을 한 행으로total 행에는 도메인이나 키워드를 언급·인용한 AI 답변 수인 mentions_count와 그 질문들의 월간 수요 합계인 ai_search_volume이 들어 있습니다.
  • 답변이 인용한 도메인source_domain 행은 해당 답변이 가장 많이 인용한 사이트 10곳을 순위대로 보여 줘, AI가 브랜드를 설명할 때 어떤 매체의 영향을 받는지 알려 줍니다.
  • AI가 살펴본 검색 결과의 도메인search_result_domain 행은 AI가 답하기 전에 살펴본 웹 검색 결과의 사이트를 순위대로 보여 줘, 답변 뒤에 있는 참고 자료 목록을 알려 줍니다.
  • 함께 등장한 브랜드와 카테고리chat_gpt에서는 brand와 brand_category 행이 같은 답변에 나온 브랜드와 제품 카테고리를 보여 줘 누구와 비교되는지 바로 알 수 있습니다.
  • 도메인이나 키워드를 대상으로사이트는 target으로, 제품명·카테고리·주제는 query로 측정하며 AI 개요와 ChatGPT 중에서 고를 수 있습니다.

AI Search Visibility API 매개변수

매개변수필수설명
target필수(하나 이상)측정할 도메인(예: hubspot.com)으로, 페이지 경로는 넣지 않습니다. target과 query 중 하나만 보냅니다.
query필수(하나 이상)측정할 키워드, 브랜드명 또는 주제(예: crm software)입니다. target과 query 중 하나만 보냅니다.
platform선택google(기본값)은 Google AI 개요를, chat_gpt는 미국·영어 환경의 ChatGPT 답변을 읽고 브랜드 행도 함께 반환합니다.
location_code선택시장 위치 코드입니다. 기본값은 2840(미국)이며 chat_gpt 답변도 이 시장을 다룹니다.
location_name선택location_code 대신 쓰는 시장 이름으로, 입력하면 location_code보다 우선합니다.
language_code선택답변 언어 코드입니다. 기본값은 en이며 chat_gpt 답변도 이 언어입니다.
language선택language_code 대신 쓰는 언어 이름으로, 입력하면 language_code보다 우선합니다.

AI Search Visibility API 사용 방법

도메인이나 키워드를 보내고 합계와 각 세부 항목을 읽습니다.

  1. {"target": "hubspot.com", "platform": "chat_gpt"}을 /v1/ai-search/llm-brand-metrics에 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items를 dimension별로 묶어 total부터 읽고, 이어서 source_domain, search_result_domain, brand, brand_category를 rank 순서로 봅니다.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"hubspot.com","platform":"chat_gpt"}'

AI Search Visibility API 추천 활용 사례

  • 경쟁사와 AI 점유율 비교: 같은 platform으로 자사와 경쟁사 두 곳의 도메인을 조회하고 total 행의 mentions_count와 ai_search_volume을 비교해 AI가 누구를 더 자주 언급하는지 확인합니다.
  • AI 노출을 떠받치는 매체 찾기: source_domain 행에서 기고나 협업을 제안할 만한 리뷰 사이트, 미디어, 커뮤니티를 고릅니다. AI가 브랜드를 언급할 때 근거로 삼는 곳이 바로 이 페이지들입니다.
  • 출시나 캠페인 이후 노출 추적: total 행을 주기적으로 저장해 제품 출시, PR, 콘텐츠 개편 전후의 값을 비교합니다.

AI Search Visibility API 활용 팁

  • brand와 brand_category 행이 필요하면 platform을 chat_gpt로 설정하세요. AI 개요 요청은 합계와 도메인 항목을 반환합니다.
  • 여러 브랜드를 비교할 때는 platform, 시장, 언어를 똑같이 맞춰야 같은 답변 묶음에서 합계를 비교할 수 있습니다.
  • 도메인이 아니라 구체적인 페이지가 필요하면 같은 target이나 query로 LLM Top Sources API를 호출하고 content_type을 pages로 설정하세요.
  • 도메인의 total 언급이 적다면 브랜드명을 query로도 조회하세요. 답변이 사이트 링크 없이 브랜드 이름만 언급하는 경우가 있습니다.

AI Search Visibility API 외에 AI Search의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • LLM Mentions API — 도메인을 인용하거나 키워드를 언급한 AI 개요와 ChatGPT 답변을 답변 전문, 인용 출처, 질문의 AI 검색량과 함께 찾습니다.
  • LLM Top Sources API — 키워드나 도메인에 대해 AI 개요와 ChatGPT 답변이 가장 많이 인용한 도메인이나 페이지 10개를 인용 수와 AI 검색량으로 순위를 매깁니다.
  • Google AI Mode API — 검색어에 대한 Google AI 모드의 전체 답변을 Markdown으로, 모든 인용 출처와 함께 원하는 국가와 언어로 가져옵니다.

다른 플랫폼 둘러보기

AI Search 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

AI Search Visibility API — 자주 묻는 질문

AI Search Visibility API는 Google AI 개요나 ChatGPT 답변이 도메인이나 키워드를 얼마나 자주 언급하는지 측정하는 API로, 해당 답변의 AI 검색량 합계, 인용하거나 참고한 도메인, ChatGPT에서는 함께 등장한 브랜드와 카테고리를 반환합니다.

합계 1행에 이어 세부 항목마다 최대 10행이 반환됩니다. 세부 항목은 인용 도메인, 검색 결과 도메인, chat_gpt의 브랜드와 브랜드 카테고리입니다.

mentions_count는 해당 도메인, 브랜드 또는 카테고리를 언급하거나 인용한 AI 답변 수이고, ai_search_volume은 그 답변들의 질문에 대한 월간 AI 검색량 합계입니다.

요청당 40크레딧에 반환된 행마다 0.5크레딧이 더해지며, 도메인이나 키워드를 언급한 답변이 없어도 40크레딧은 부과됩니다.