AI SearchGEOLLM 언급Google AI ModeAPI 가이드

AI 검색 API: LLM 언급, AI 가시성, Google AI Mode 답변 추적하기

SocQ의 AI Search 신규 엔드포인트 4개로 도메인을 인용하는 AI Overviews와 ChatGPT 답변, AI 점유율, 가장 많이 인용되는 출처, Google AI Mode 전체 답변을 가져올 수 있습니다.

SocQ2026년 11월 19일 업데이트약 8분 소요

생성형 엔진 최적화(GEO)를 하고 있다면 AI 답변이 무엇을 말하는지에 대한 데이터가 필요합니다. 어떤 질문에서 내 도메인이 인용되는지, 경쟁사와 비교해 내 브랜드가 얼마나 자주 등장하는지, AI가 내 카테고리에서 어떤 사이트를 신뢰하는지, Google AI Mode가 특정 검색에 대해 무엇을 쓰는지 같은 데이터입니다. 2026-11-17에 SocQ는 새로운 AI Search 플랫폼에 이를 위한 엔드포인트 4개를 추가했습니다. 이 가이드에서는 각 엔드포인트의 반환 내용, 요청 예시, 가격, 사용 시점을 정리합니다.

빠른 답변: AI Overviews나 ChatGPT 답변을 읽으려면 도메인(target)이나 키워드(query)를 POST /v1/ai-search/llm-mentions, /llm-brand-metrics, /llm-top-mentioned로 보내세요. 출처가 포함된 AI Mode 답변 하나를 받으려면 검색어를 POST /v1/ai-search/google-ai-mode로 보내면 됩니다. 결과는 GET /v1/tasks/{task_id}를 폴링해 읽습니다.

신규 AI Search 엔드포인트

1 SocQ 크레딧 = $0.005입니다.

엔드포인트반환 내용가격
LLM Mentions API도메인을 인용하거나 키워드를 언급하는 AI 답변마다 한 행: 질문, Markdown 형식의 전체 답변, 인용 출처, AI 검색량요청당 40 크레딧($0.20) + 답변당 0.5 크레딧($0.0025)
AI Search Visibility API도메인이나 키워드를 언급하는 AI 답변 총계와 인용 도메인, 웹 결과 도메인, (ChatGPT의 경우) 브랜드와 브랜드 카테고리별 분석요청당 40 크레딧($0.20) + 행당 0.5 크레딧($0.0025)
LLM Top Sources API키워드나 도메인에 대해 AI 답변이 인용하는 상위 10개 도메인 또는 페이지, 언급 수 순요청당 40 크레딧($0.20) + 순위 도메인 또는 페이지당 0.5 크레딧($0.0025)
Google AI Mode API검색어에 대한 Google AI Mode 전체 답변(Markdown)과 모든 인용 출처요청당 2 크레딧($0.01)

세 LLM 엔드포인트는 아무것도 찾지 못한 경우에도 기본 요금 40 크레딧이 부과됩니다.

인증과 비동기 작업 흐름

모든 SocQ 요청은 Authorization 헤더의 API 키로 인증하며, 작업 제출, 작업 상태 조회, 결과 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 응답에는 data.task_id와 data.status가 들어 있습니다. 이 ID로 작업 엔드포인트를 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded이면 응답의 data.results.items에 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있습니다. has_more가 true이면 results.next_cursor를 cursor로 넘겨 다음 페이지를 읽으세요. 작업이 queued, running, failed 상태인 동안에는 results 없이 작업 메타데이터만 반환됩니다.

제출 본문에 선택 항목인 callback_url을 넣으면 작업이 끝났을 때 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 GET /v1/tasks/{task_id}로 읽으면 됩니다. 클라이언트 측 타임아웃이 발생해도 작업은 취소되지 않으므로, 중복 비용을 내지 말고 같은 작업 ID로 조회를 이어가세요. 402는 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

LLM Mentions API: 나를 인용하는 답변

LLM Mentions API는 Google AI Overviews나 ChatGPT가 내 도메인을 인용하거나 답변에 내 브랜드 또는 키워드가 등장하는 질문을 나열합니다. target에 도메인을 넣거나 query에 키워드를 넣되, 둘 다 넣을 수는 없습니다. platform은 google(AI Overviews, 기본값) 또는 chat_gpt이며, ChatGPT는 미국 영어 기준으로 추적됩니다. results_limit의 기본값은 100이며 1~1,000을 지정할 수 있습니다.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "notion.so",
    "platform": "google",
    "results_limit": 100
  }'

각 행은 질문과 답변 한 쌍입니다. 가장 많이 쓰게 될 필드는 다음과 같습니다.

  • question과 answer: 질문과 Markdown 형식의 전체 답변.
  • ai_search_volume: 해당 질문이 한 달에 검색되는 예상 횟수.
  • sources: position, title, url, domain, source, text를 포함한 인용 페이지.
  • search_results와 brands: AI가 참고한 웹 결과와 AI가 언급한 브랜드(ChatGPT 전용).
  • fan_out_queries: AI가 추가로 실행한 후속 검색.
  • first_seen_at과 last_seen_at: 답변이 처음과 마지막으로 기록된 시점.

GEO 커버리지를 점검하거나, 내 분야에서 AI가 신뢰하는 페이지를 찾거나, 내 제품을 잘못 설명하는 답변을 잡아낼 때 사용하세요. 답변 100개는 90 크레딧($0.45)입니다. 모든 필드는 LLM Mentions 문서를 참고하세요.

AI Search Visibility API: AI 답변 속 점유율

AI Search Visibility API는 점유율(share of voice) 보고서입니다. 첫 행에는 내 도메인이나 키워드를 언급하는 AI 답변의 총수와 그 바탕이 되는 월간 AI 검색량이 담깁니다. 그 뒤로 분석 항목마다 최대 10행이 이어집니다. 답변이 가장 많이 인용하는 도메인, AI가 참고한 웹 결과의 도메인, 그리고 chat_gpt의 경우 같은 답변에 언급된 브랜드와 브랜드 카테고리입니다.

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"
  }'

각 행에는 dimension(total, source_domain, search_result_domain, brand, brand_category), name, 해당 분석 항목 내 rank, mentions_count, ai_search_volume이 들어 있습니다. 내 브랜드와 경쟁사 두 곳에 대해 실행하면 AI가 누구를 추천하는지 비교할 수 있습니다. 총계와 네 가지 분석 항목을 모두 채운 ChatGPT 보고서는 41행, 즉 60.5 크레딧($0.3025)입니다. 필드 설명: AI Search Visibility 문서.

LLM Top Sources API: 주제별로 AI가 인용하는 사이트

LLM Top Sources API는 다른 질문에 답합니다. 사람들이 내 카테고리에 대해 물을 때 AI는 어떤 사이트를 인용할까요? query에 키워드를 넣거나 target에 도메인을 넣으세요. content_type은 domains(기본값) 또는 pages로 설정합니다. results_limit의 기본값은 10이며, 이 값이 최대치이기도 합니다.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "crm software",
    "platform": "google",
    "content_type": "domains"
  }'

행은 AI Search Visibility와 같은 지표 구조를 사용하며, dimension은 domain 또는 page입니다. 페이지 보기는 디지털 PR 아웃리치에 바로 쓸 수 있는 후보 목록이 됩니다. 순위 10행은 45 크레딧($0.225)입니다. 자세한 내용: LLM Top Sources 문서.

Google AI Mode API: 출처가 포함된 전체 답변 하나

AI Mode는 링크 목록 대신 완성된 답변을 작성해 주는 Google 검색의 대화형 탭입니다. Google AI Mode API는 query를 받아 그 답변을 Markdown으로 반환하고, 답변이 인용한 출처를 중복 없이 정리한 목록도 함께 제공합니다. 기본값은 미국(location_code 2840)과 영어(language_code en)이며, 값을 바꾸면 국가와 언어별 답변을 비교할 수 있습니다.

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"
  }'

요청마다 query, answer, references(순위, 제목, URL, 도메인, 출처, 발췌문), location_code, language_code, AI Mode 페이지의 url을 담은 행 하나가 반환됩니다. 검색당 2 크레딧($0.01)이므로, 중요한 검색어에서 내 페이지가 출처에 포함되는지 저렴하게 확인할 수 있습니다. Google AI Mode 문서를 참고하세요.

어떤 엔드포인트를 써야 할까요?

  • "어떤 AI 답변이 우리를 언급하고, 뭐라고 말하나요?" LLM Mentions를 사용하세요.
  • "경쟁사와 비교해 AI 답변에서 우리는 얼마나 잘 보이나요?" AI Search Visibility를 도메인마다 한 번씩 실행하세요.
  • "AI가 우리를 인용하게 하려면 어떤 사이트에 제안해야 하나요?" content_type: "pages"로 LLM Top Sources를 사용하세요.
  • "이 시장에서 바로 이 검색어에 대해 Google AI Mode는 뭐라고 하나요?" Google AI Mode를 사용하세요.

일반적인 순서는 카테고리에 대해 LLM Top Sources를 실행하고, 내 브랜드와 경쟁사에 대해 AI Search Visibility를 실행한 다음, LLM Mentions로 수치 뒤에 있는 답변을 읽는 것입니다. 기존 검색 순위는 SEO 플랫폼을 참고하세요.

자주 묻는 질문(FAQ)

AI 검색 API란 무엇인가요?

링크 목록 대신 AI 답변 엔진이 무엇을 말하는지 반환하는 API입니다. SocQ의 AI 검색 API는 도메인이나 키워드를 언급하는 AI Overviews와 ChatGPT 답변, 가시성 지표, 가장 많이 인용되는 출처, Google AI Mode 전체 답변을 다룹니다.

어떤 AI 플랫폼을 지원하나요?

세 LLM 엔드포인트는 platform에 google(AI Overviews, 기본값) 또는 chat_gpt를 받습니다. ChatGPT는 미국 영어 기준으로 추적됩니다. 브랜드와 브랜드 카테고리 행, AI가 참고한 웹 결과, 브랜드 목록은 chat_gpt에서만 제공됩니다.

한 요청에 도메인과 키워드를 함께 보낼 수 있나요?

아니요. LLM Mentions, AI Search Visibility, LLM Top Sources는 target(도메인)이나 query(키워드) 중 하나만 받습니다. 두 관점이 모두 필요하면 요청을 두 번 보내세요.

AI 답변을 하나도 찾지 못해도 과금되나요?

네. 세 LLM 엔드포인트는 아무것도 찾지 못해도 기본 요금 40 크레딧이 부과되며, 결과당 크레딧은 반환된 행에만 적용됩니다. Google AI Mode는 요청당 2 크레딧입니다.

일반적인 GEO 감사에는 비용이 얼마나 드나요?

LLM Top Sources 요청 1회(45 크레딧), ChatGPT 가시성 보고서 3회(각 최대 60.5 크레딧), 답변 100개짜리 LLM Mentions 요청 1회(90 크레딧)를 합치면 최대 316.5 크레딧, 약 $1.58입니다. 가격은 바뀔 수 있으므로 먼저 엔드포인트 페이지를 확인하세요.

AI SEARCH API

공개 AI Search URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

AI Search API 살펴보기