ai-search/
google-ai-mode

검색어를 보내면 Google AI 모드가 작성한 전체 답변을 Markdown으로 받고, 중복을 제거한 인용 출처 목록을 제목, URL, 도메인, 발췌문과 함께 받습니다.

Google AI Mode API

Markdown 전체 답변
인용 출처
국가·언어 선택
검색당 한 행
요청당 2 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Google AI Mode

Google AI 모드는 Google 검색의 대화형 탭으로, 검색어에 대해 링크 목록 대신 완성된 답변을 쓰고 본문 옆에 근거로 삼은 페이지를 표시합니다. 비즈니스에 중요한 검색의 답변을 읽어 보면 Google이 카테고리를 어떻게 설명하는지, 자사 사이트가 인용 출처에 들어 있는지, 어떤 경쟁사가 추천되는지, 국가나 언어에 따라 답변이 어떻게 달라지는지 알 수 있습니다.

Google AI Mode API 주요 기능

  • 서식을 유지한 전체 답변answer는 AI 모드 답변을 제목, 목록, 표까지 포함한 Markdown으로 담아 바로 저장하거나 비교하거나 표시할 수 있습니다.
  • 인용 출처는 한 번씩만references는 답변이 인용한 출처를 중복 없이 나열하며 position, title, url, domain, 사이트 이름, 답변 옆에 표시된 발췌문을 포함합니다.
  • 시장 선택location_code나 location_name, language_code나 language로 검색 국가와 언어를 정해 같은 검색어를 여러 시장에서 읽어 볼 수 있습니다.
  • 실제 페이지로 가는 링크url은 같은 검색어의 AI 모드 페이지를 열어 답변을 직접 확인할 때 유용합니다.

Google AI Mode API 매개변수

매개변수필수설명
query필수AI 모드에 물어볼 검색어(예: best crm for startups)입니다.
location_code선택검색 시장의 위치 코드입니다. 기본값은 2840(미국)입니다.
location_name선택location_code 대신 쓰는 시장 이름으로, 입력하면 location_code보다 우선합니다.
language_code선택검색 언어 코드입니다. 기본값은 en입니다.
language선택language_code 대신 쓰는 언어 이름으로, 입력하면 language_code보다 우선합니다.

Google AI Mode API 사용 방법

검색어를 보내고 답변과 출처를 읽습니다.

  1. {"query": "best crm for startups", "location_code": 2840, "language_code": "en"}을 /v1/ai-search/google-ai-mode에 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items의 한 행에서 answer로 본문을, references로 인용된 페이지를 읽습니다.
curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best crm for startups","location_code":2840,"language_code":"en"}'

Google AI Mode API 추천 활용 사례

  • 자사 페이지 인용 여부 확인: 핵심 검색어를 조회해 references에서 자사 도메인을 찾고, 그 위치와 Google이 보여 준 발췌문을 기록합니다.
  • AI 모드가 추천하는 브랜드 파악: 카테고리 추천 도구처럼 구매 의도가 있는 검색의 answer를 읽고 어떤 제품이 어떤 순서로 언급되는지 기록합니다.
  • 시장별 답변 비교: 같은 검색어를 다른 지역·언어 설정으로 조회해 AI 모드가 시장마다 다르게 설명하는 부분에 맞춰 콘텐츠를 현지화합니다.

Google AI Mode API 활용 팁

  • 답변을 꾸준히 추적한다면 Markdown answer를 저장해 버전끼리 비교하세요. 표현 변화가 텍스트 차이로 그대로 드러납니다.
  • 답변이 경쟁사 페이지를 인용했다면 해당 references 항목의 발췌문을 읽어 Google이 어떤 대목을 근거로 삼았는지 확인하세요.
  • 검색 한 번이 아니라 여러 질문에 걸친 AI 답변을 보고 싶다면 자사 도메인을 target으로 LLM Mentions API를 사용하세요.

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

  • LLM Mentions API — 도메인을 인용하거나 키워드를 언급한 AI 개요와 ChatGPT 답변을 답변 전문, 인용 출처, 질문의 AI 검색량과 함께 찾습니다.
  • AI Search Visibility API — AI 답변이 도메인이나 키워드를 언급한 횟수와 AI 검색량, 자주 인용된 도메인, ChatGPT에서 함께 언급된 브랜드를 측정합니다.
  • LLM Top Sources API — 키워드나 도메인에 대해 AI 개요와 ChatGPT 답변이 가장 많이 인용한 도메인이나 페이지 10개를 인용 수와 AI 검색량으로 순위를 매깁니다.

다른 플랫폼 둘러보기

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

Google AI Mode API — 자주 묻는 질문

Google AI Mode API는 AI 모드가 검색어에 대해 작성한 전체 답변을 Markdown으로 반환하고, 중복을 제거한 인용 출처와 그 제목, URL, 도메인, 발췌문을 함께 반환하는 API입니다.

AI 모드는 Google 검색의 독립된 대화형 탭으로 검색어마다 완성된 답변을 쓰며, 이 API는 그 탭을 읽습니다. AI 개요 답변은 LLM Mentions API에서 다룹니다.

네. 기본값은 미국(2840)과 영어(en)이며 location_code나 location_name, language_code나 language로 바꿀 수 있습니다.

요청당 2크레딧이며, 답변과 출처가 담긴 한 행이 반환됩니다.