ai-search/
llm-mentions

도메인을 인용하거나 키워드를 언급한 AI 개요와 ChatGPT 답변을 찾아 질문, Markdown 형식의 답변 전문, 인용 출처, 질문의 월간 AI 검색량을 반환합니다.

LLM Mentions API

AI 개요와 ChatGPT
답변 전문
인용 출처
AI 검색량
요청당 40 크레딧 + 결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

LLM Mentions

LLM 언급이란 Google AI 개요나 ChatGPT가 어떤 질문에 답하면서 도메인을 인용하거나 키워드를 언급한 경우를 말하며, 답변 전문, 인용된 페이지, 답변한 모델, 그 질문이 매달 얼마나 검색되는지가 함께 기록되고 ChatGPT 답변에는 언급된 브랜드와 추가로 실행한 검색도 남습니다. 이런 답변을 나란히 놓고 보면 어떤 질문에서 브랜드가 AI 사용자에게 노출되는지, 모델이 어떤 출처에 기대는지, 제품을 잘못 설명한 답변이 무엇인지 알 수 있어 생성형 엔진 최적화(GEO) 점검, 콘텐츠 기획, 경쟁사 비교에 쓰입니다.

LLM Mentions API 주요 기능

  • 도메인이나 키워드로 시작target은 notion.so 같은 도메인을 인용한 답변을, query는 키워드나 브랜드명을 언급한 답변을 찾아 자사 사이트와 카테고리 표현을 모두 추적할 수 있습니다.
  • 사용자가 본 그대로의 답변answer는 제목, 목록, 본문 링크를 포함한 답변 전문을 Markdown으로 보존하므로 모델이 쓴 표현을 그대로 인용하고 검토할 수 있습니다.
  • 답변이 인용한 모든 페이지sources에는 인용 페이지별 순서, 제목, URL, 도메인, 사이트 이름, 발췌문이 담겨 어떤 콘텐츠가 답변을 만들었는지 보여 줍니다.
  • 질문별 수요ai_search_volume은 질문이 한 달에 몇 번 검색되는지에 대한 추정치라, 수요가 큰 질문의 언급과 드문 질문의 언급을 구분할 수 있습니다.
  • ChatGPT의 브랜드, 참고 페이지, 추가 검색platform을 chat_gpt로 하면 brands에 답변 속 브랜드가 등장 순서대로, search_results에 ChatGPT가 참고한 페이지가, fan_out_queries에 추가로 실행한 검색이 들어갑니다.
  • 답변이 기록된 시점first_seen_at과 last_seen_at이 답변마다 기록 시점을 알려 줘 오래된 답변과 새 답변을 나눌 수 있습니다.

LLM Mentions API 매개변수

매개변수필수설명
target필수(하나 이상)AI 답변에서 추적할 도메인(예: hubspot.com)으로, 페이지 경로는 넣지 않습니다. target과 query 중 하나만 보냅니다.
query필수(하나 이상)AI 답변에서 추적할 키워드나 브랜드명(예: crm software), 최대 250자입니다. 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보다 우선합니다.
results_limit선택가져올 답변 수의 상한으로 1~1000, 기본값은 100입니다.

LLM Mentions API 사용 방법

도메인이나 키워드를 보내면 AI 답변마다 한 행으로 받습니다.

  1. {"target": "notion.so", "platform": "google", "results_limit": 100}을 /v1/ai-search/llm-mentions에 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 답변을 읽고, has_more가 true인 동안 results.next_cursor로 다음 페이지를 요청합니다.
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}'

LLM Mentions API 추천 활용 사례

  • AI 답변 속 자사 도메인 노출 점검: 자사 도메인을 target으로 넣고 ai_search_volume 순으로 정렬한 뒤 answer와 sources를 읽으면, 수요가 큰 어떤 질문에서 인용되고 어떻게 설명되는지 확인할 수 있습니다.
  • 카테고리에서 AI가 기대는 페이지 찾기: 카테고리 키워드를 query로 넣고 sources의 도메인과 URL을 집계해 기고하거나 보강할 만한 글 목록을 만듭니다.
  • ChatGPT 답변 속 브랜드 비교: platform을 chat_gpt로 두고 자사와 경쟁사를 각각 조회해 같은 질문들에서 brands의 구성과 등장 순서를 비교합니다.
  • 빠져 있는 주제로 콘텐츠 기획: 자사 브랜드가 나오지 않는 답변의 question과 fan_out_queries를 모아 모델이 인용할 수 있는 페이지 기획안으로 만듭니다.

LLM Mentions API 활용 팁

  • 같은 브랜드라도 도메인은 target, 브랜드명은 query로 둘 다 조회하세요. 사이트 인용과 이름 언급은 서로 다른 답변 묶음을 돌려줍니다.
  • 필요한 답변은 results_limit을 넉넉히 잡아 한 번의 요청으로 받으세요. 40크레딧 기본료는 요청마다 붙습니다.
  • 각 행의 id를 저장해 두고 다음 실행 때 last_seen_at과 비교하면 새 답변과 이미 본 답변을 구분할 수 있습니다.

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

  • AI Search Visibility API — AI 답변이 도메인이나 키워드를 언급한 횟수와 AI 검색량, 자주 인용된 도메인, ChatGPT에서 함께 언급된 브랜드를 측정합니다.
  • LLM Top Sources API — 키워드나 도메인에 대해 AI 개요와 ChatGPT 답변이 가장 많이 인용한 도메인이나 페이지 10개를 인용 수와 AI 검색량으로 순위를 매깁니다.
  • Google AI Mode API — 검색어에 대한 Google AI 모드의 전체 답변을 Markdown으로, 모든 인용 출처와 함께 원하는 국가와 언어로 가져옵니다.

다른 플랫폼 둘러보기

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

LLM Mentions API — 자주 묻는 질문

LLM Mentions API는 도메인이나 키워드 하나를 받아 이를 인용하거나 언급한 Google AI 개요와 ChatGPT 답변을 반환하는 API입니다. 각 행에는 질문, 답변 전문, 인용 출처, 모델, 질문의 월간 AI 검색량이 들어 있습니다.

platform이 google이면 선택한 시장의 Google AI 개요를, chat_gpt면 미국·영어 환경의 ChatGPT 답변을 읽습니다.

사이트를 인용한 답변을 찾으려면 target에 도메인을, 단어나 브랜드명을 언급한 답변을 찾으려면 query를 씁니다. 한 요청에는 둘 중 하나만 넣습니다.

브랜드명, 참고한 웹 결과, 추가 검색은 ChatGPT 답변에서 기록되므로 받으려면 platform을 chat_gpt로 설정하세요.

요청당 40크레딧에 반환된 답변 1건마다 0.5크레딧이 더해지며, 일치하는 답변이 없어도 40크레딧은 부과됩니다.