체인지로그새 기능

시장 전체를 추적하는 카테고리 모니터가 나왔어요

Monitors
답변에 언급된 비율로 노트북 브랜드 순위를 보여 주는 카테고리 리포트

카테고리 모니터로 AI 엔진이 한 시장에서 언급하는 브랜드 순위와 점유율, 일별 추이를 보세요.

받는 결과

  • 답변이 언급한 모든 추적 브랜드의 순위표에 순위, 언급률, 점유율, 직전 기간 대비 변화가 담깁니다.
  • 세부 분야별, 엔진별로 가장 많이 언급된 브랜드 3곳이 나와 브랜드마다 강한 영역이 보입니다.
  • 상위 5개 브랜드의 일별 언급률과, 프롬프트와 엔진마다 근거 답변을 여는 칸이 있습니다.

동작 방식

브랜드 모니터는 브랜드 하나를 따라갑니다. 카테고리 모니터는 시장을 따라갑니다. 카테고리 이름을 정하고 프롬프트를 세부 분야로 묶으면, 실행마다 엔진에 그 프롬프트를 묻고 답변마다 언급된 브랜드를 기록합니다. 만들 때 mode를 CATEGORY로 지정하세요. 유형은 모니터가 있는 동안 그대로 유지됩니다.

  • category: 구매자가 부르는 시장 이름으로, 1~80자입니다.
  • promptTopics: 프롬프트를 세부 분야에 연결합니다. 세부 분야는 30개까지, 이름은 60자까지입니다. 연결 목록 밖의 프롬프트는 카테고리 전체를 다룹니다.
  • competitors: 직접 입력하는 브랜드 25곳까지입니다. 첫 실행 뒤에는 매주 답변을 읽어 언급된 브랜드를 25곳까지 더합니다.

GET /v1/monitors/{id}/analytics가 리포트를 돌려줍니다. category.brands의 점유율은 100 × 브랜드 언급 수 ÷ 추적 브랜드 전체 언급 수라서, 한 기간의 점유율을 모두 더하면 100이 됩니다. 브랜드별 언급률은 그 브랜드가 목록에 있던 동안 채점한 답변 수인 sampleSize로 나누므로, 오늘 추가한 브랜드는 오늘부터 측정됩니다.

이렇게 활용하세요

  • 내 시장에서 AI 답변을 이끄는 브랜드와 그 격차를 확인합니다.
  • 경쟁사마다 강한 세부 분야와 엔진을 파악합니다.
  • 카테고리 점유율을 매주 고객이나 경영진에게 보고합니다.

시작하기

대시보드에서 새 모니터를 만들고 모니터 유형으로 카테고리를 고르세요. 주제를 입력하고 리서치 실행을 누르면 Prompt Research가 KR 또는 US의 검색 수요를 바탕으로 프롬프트, 세부 분야, 순위를 낼 브랜드를 채워 주고, 모니터를 만들기 전에 모두 검토합니다.

요청 보내기

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 market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

요청 필드

namestring필수
모니터 이름입니다.
modestring필수
BRAND(기본값)는 내 브랜드를, CATEGORY는 시장의 모든 브랜드 순위를 추적합니다.
categorystring필수
시장 이름, 1~80자.
enginesarray필수
질문할 엔진, 최대 12개. CHATGPT, GEMINI, PERPLEXITY, GOOGLE 등.
promptsarray필수
실행마다 묻는 질문 1~100개. 구매자가 묻는 말투로 씁니다.
promptTopicsobject
프롬프트마다 Kids 같은 세부 분야를 붙입니다. 리포트가 세부 분야별로 브랜드 순위를 냅니다.
competitorsarray
처음부터 순위에 넣을 브랜드, 최대 25개. 매주 분석이 답변에서 최대 25개를 더합니다.
countrystring
엔진이 답하는 시장입니다. 기본값 US.
intervalHoursinteger
실행 간격(시간), 1~168. 1은 매시간, 24는 매일, 168은 매주.

응답

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

JSON
{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}
data.monitor.idstring
모니터 ID입니다. 리포트, 채점 결과, 답변 원문을 읽을 때 씁니다.
data.monitor.nextRunAtstring
다음 실행 시각입니다. 첫 실행은 모니터를 만드는 즉시 시작되고, 이후 intervalHours마다 실행됩니다.

리포트 읽기

GET /v1/monitors/{id}/analytics가 최근 30일 리포트를 돌려줍니다. 아래 숫자는 공개된 러닝화 리포트에서 가져와 길이를 줄인 것입니다.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
JSON
{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}
category.brandsarray
목록의 브랜드와 답변이 언급한 다른 모든 브랜드를 많이 언급된 순서로 담고, rank, mentionRate, shareOfVoice가 함께 옵니다.
category.topicsarray
세부 분야별 같은 순위로, 모니터가 묻는 순서대로 나옵니다.

답변 내보내기

GET /v1/monitors/{id}/results는 답변마다 한 행씩, 답변이 언급한 브랜드를 competitorHits에 담아 돌려줍니다. format=csv를 붙이면 어느 스프레드시트에서나 열리는 파일로 받습니다.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results?format=csv" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
CSV
ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

요금

실행 비용은 브랜드 모니터와 같습니다. 프롬프트와 엔진마다 태스크 하나가 엔진별 크레딧으로 실행됩니다. 시장의 브랜드를 찾는 데 한 달 100크레딧이 실행마다 나눠 청구되고, 폼을 채우는 리서치는 12크레딧입니다.

다른 업데이트

새 소식을 받아보세요

제품 업데이트를 이메일로 보내드립니다.

RSS 구독