AI 답변 속 내 브랜드를 모니터로 지켜봐요

모니터는 질문 세트를 고른 AI 엔진에 정해진 주기로 보내고, 모든 답변에서 내 브랜드의 언급과 인용을 채점해요.

받는 결과

• 언급률: 내 브랜드를 언급한 답변의 비율을 엔진별, 질문별로 봅니다.
• 인용률: 내 도메인을 인용한 답변의 비율입니다.
• 질문과 엔진을 교차한 표에서 내 브랜드가 나오는 곳을 보고, 칸마다 그 뒤의 답변 전문을 엽니다.
• 언급률이 설정한 기준 아래로 떨어지면 이메일 알림을 받습니다.

동작 방식

모니터는 한 시장을 위한 이름 붙은 질문 세트입니다. 질문, 물어볼 엔진, 내 브랜드를 뜻하는 이름, 내 도메인, 국가, 1시간에서 1주일 사이의 실행 주기로 이뤄집니다. 실행마다 모든 질문을 모든 엔진에 보내고 답변마다 한 번씩 채점합니다. 내 브랜드를 언급했는지와 그 위치, 내 도메인을 인용했는지, 어떤 경쟁사가 함께 나왔는지를 기록합니다.

모든 숫자가 그 뒤의 답변으로 이어지므로, 비율이 움직이면 바뀐 답변을 바로 열어 엔진이 무엇을 말했는지 확인합니다.

이렇게 활용하세요

• 구매자가 묻는 질문에서 AI 답변 속 내 브랜드 비중을 주 단위로 추적합니다.
• 경쟁사가 나보다 앞서 언급되는 질문과 엔진을 찾습니다.
• 새 콘텐츠를 게시한 뒤 언급률과 인용률이 어떻게 움직이는지 봅니다.

시작하기

대시보드의 모니터 메뉴나 POST /v1/monitors로 모니터를 만드세요. 브랜드 이름이 들어간 질문은 항상 언급으로 집계되므로, 질문은 구매자가 실제로 쓰는 말로 적으세요.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes, US",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "best running shoes for flat feet",
      "most comfortable running shoes for beginners"
    ],
    "aliases": ["Acme", "Acme Running"],
    "domains": ["acme.com"],
    "country": "US",
    "intervalHours": 24,
    "alertBelowPct": 30
  }'

요청 필드

namestring필수

모니터 이름입니다.

enginesarray필수

질문할 엔진, 최대 12개. CHATGPT, GEMINI, PERPLEXITY, GOOGLE 등.

promptsarray필수

실행마다 묻는 질문 1~100개. 구매자가 묻는 말투로 씁니다.

aliasesarray필수

브랜드 이름과 표기, 최대 20개. 답변에 하나라도 나오면 언급으로 셉니다.

domainsarray

내 사이트, 최대 20개. 답변이 이 사이트를 인용하면 인용으로 셉니다.

competitorsarray

비교할 브랜드로, 각각 name과 aliases를 넣습니다. 매주 분석이 답변에 나온 브랜드를 더합니다.

countrystring

엔진이 답하는 시장입니다. 기본값 US.

intervalHoursinteger

실행 간격(시간), 1~168. 1은 매시간, 24는 매일, 168은 매주.

alertBelowPctinteger

언급률이 이 비율 아래로 내려가면 이메일로 알립니다. 1~100.

응답

응답입니다. 길이를 줄여 보여 드립니다.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes, US",
      "mode": "BRAND",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 24,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}

data.monitor.idstring

모니터 ID입니다. 리포트, 채점 결과, 답변 원문을 읽을 때 씁니다.

data.monitor.nextRunAtstring

다음 실행 시각입니다. 첫 실행은 모니터를 만드는 즉시 시작되고, 이후 intervalHours마다 실행됩니다.

결과 읽기

실행마다 프롬프트와 엔진 조합당 한 행이 쌓입니다. GET /v1/monitors/{id}/results는 최신 행부터 돌려주고, 다음 페이지는 nextCursor를 cursor로 넘겨 받습니다. 아래 행은 공개된 러닝화 리포트에서 가져와 길이를 줄였습니다.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)"
    },
    "truncated": true,
    "nextCursor": "2026-09-30T11:51:14.888000Z~7fc7c713-a2f2-41f8-befd-c04b830d69e5",
    "results": [
      {
        "taskId": "bc96f867-7349-4987-b498-f0080c149f3d",
        "engine": "PERPLEXITY",
        "prompt": "What are the best waterproof running shoes to choose?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:33.415000Z",
        "competitorHits": ["HOKA", "On", "Brooks", "Salomon"]
      },
      {
        "taskId": "6b8222fd-01bd-44d7-9a0b-8d0aecb32e19",
        "engine": "PERPLEXITY",
        "prompt": "What are the best running shoes for kids?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:14.888000Z",
        "competitorHits": ["HOKA", "On", "ASICS", "Nike", "New Balance"]
      }
    ]
  }
}

mentionedboolean

답변이 aliases 중 하나로 내 브랜드를 언급하면 true입니다.

citedboolean

답변이 내 domains의 페이지를 인용하면 true입니다.

positioninteger

답변에서 내 브랜드가 처음 언급된 글자 위치로, 얼마나 앞에 나왔는지 보여 줍니다. 브랜드가 빠진 답변은 null입니다.

competitorHitsarray

답변이 언급한 경쟁사입니다.

taskIdstring

그 행의 답변입니다. GET /v1/monitors/{id}/answers/{taskId}로 출처와 함께 전문을 받습니다.

요금

실행 한 번의 비용은 질문 수에 엔진별 크레딧을 곱한 값입니다. 예를 들어 질문 12개를 ChatGPT(2크레딧)와 Gemini(1크레딧)에 보내면 실행마다 36크레딧, 매일 실행하면 한 달에 약 1,080크레딧입니다.