모니터 리포트: 언급률, 보이스 점유율, 분석 데이터

GET /v1/monitors/{id}/analytics(레퍼런스)는 모니터 리포트의 모든 숫자를 하나의 답변 집합에서 반환합니다. 기간 하나, 필터 세트 하나, 그리고 비교용으로 그 직전의 같은 길이 기간입니다. 직접 만드는 리포트의 모든 패널을 이 엔드포인트로 구성하고, 숫자보다 quality를 먼저 읽으세요. 리포트 조회에는 비용이 들지 않습니다.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics?since=2026-10-16T00:00:00Z&until=2026-10-18T00:00:00Z&engine=CHATGPT" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

쿼리 파라미터

파라미터	설명
`days`	`7`, `30`(기본값), `90` 중 하나이며 기간은 현재 시점에서 끝납니다. `since`, `until`과 함께 쓸 수 없습니다.
`since`, `until`	고정 기간. 둘 다 보내야 하며, `2026-10-16T00:00:00Z`처럼 시간대가 포함된 ISO 8601 시각이어야 합니다. 기간은 양수이고 최대 90일이며, `until`은 미래일 수 없습니다. `2026-10-16` 같은 단순 날짜는 거부됩니다.
`engine`	이 엔진의 답변만: 모니터 엔진 id 또는 `GOOGLE_AIO` 같은 별칭.
`prompt`	이 프롬프트의 답변만, 정확한 텍스트, 1–2,000자. 답변은 프롬프트 텍스트로 저장되므로 모니터에서 뺀 프롬프트도 계속 조회할 수 있습니다.

기간은 반개구간이며 UTC 기준입니다. since는 포함하고 until은 제외합니다. 이전 기간은 길이가 정확히 같고, since에서 끝나며, 같은 필터를 쓰므로 모든 비교는 같은 조건끼리입니다. 각 파라미터는 한 번만 보내세요.

예시

ChatGPT에 프롬프트 두 개를 하루 한 번 samples: 5로 묻는(하루 답변 10개) 브랜드 모니터를 ChatGPT로 거르고 이틀 기간으로 조회하면 다음을 반환합니다.

전체 응답

{
  "success": true,
  "data": {
    "monitor": {
      "id": "d39b8de0-b159-4229-bf58-7064e5369db1",
      "name": "Earbud brand tracking",
      "mode": "BRAND",
      "category": null,
      "promptTopics": {},
      "engines": ["CHATGPT", "GEMINI"],
      "prompts": ["best wireless earbuds for commuting", "are cheap earbuds worth it"],
      "aliases": ["Acme Audio", "Acme"],
      "domains": ["acme-audio.example"],
      "country": "US",
      "intervalHours": 24,
      "enabled": true,
      "alertBelowPct": 40,
      "competitors": [
        { "name": "Northwind Audio", "aliases": ["Northwind Audio"], "source": "user" },
        { "name": "Contoso Sound", "aliases": ["Contoso Sound", "Contoso"], "source": "user" }
      ],
      "competitorsReadAt": "2026-10-17T03:10:22.004Z",
      "location": null,
      "grid": null,
      "engineSettings": { "CHATGPT": { "samples": 5 } },
      "webhookUrl": null,
      "analysis": false,
      "nextRunAt": "2026-10-19T09:00:02.118Z",
      "lastRunAt": "2026-10-18T09:00:01.730Z",
      "shareAccess": "PRIVATE",
      "shareSlug": null,
      "createdAt": "2026-10-09T08:59:57.410Z",
      "updatedAt": "2026-10-12T14:21:09.882Z"
    },
    "window": {
      "since": "2026-10-16T00:00:00.000Z",
      "until": "2026-10-18T00:00:00.000Z",
      "previousSince": "2026-10-14T00:00:00.000Z",
      "previousUntil": "2026-10-16T00:00:00.000Z",
      "timezone": "UTC",
      "bounds": "[since, until)"
    },
    "filters": { "engine": "CHATGPT", "prompt": null },
    "stats": { "runs": 20, "mentioned": 9, "cited": 3, "competitorOnly": 7, "mentionRate": 45, "citationRate": 15, "competitorOnlyRate": 35 },
    "previous": { "runs": 20, "mentioned": 12, "cited": 4, "competitorOnly": 5, "mentionRate": 60, "citationRate": 20, "competitorOnlyRate": 25 },
    "changes": { "mentionRatePp": -15, "citationRatePp": -5 },
    "engineRates": [
      { "engine": "CHATGPT", "runs": 20, "mentioned": 9, "cited": 3, "competitorOnly": 7, "mentionRate": 45, "citationRate": 15, "competitorOnlyRate": 35 }
    ],
    "series": [
      {
        "day": "2026-10-16",
        "engine": "CHATGPT",
        "partial": false,
        "runs": 10,
        "mentioned": 5,
        "cited": 2,
        "competitorOnly": 3,
        "mentionRate": 50,
        "citationRate": 20,
        "competitorOnlyRate": 30
      },
      {
        "day": "2026-10-17",
        "engine": "CHATGPT",
        "partial": false,
        "runs": 10,
        "mentioned": 4,
        "cited": 1,
        "competitorOnly": 4,
        "mentionRate": 40,
        "citationRate": 10,
        "competitorOnlyRate": 40
      }
    ],
    "brands": [
      {
        "name": "Northwind Audio",
        "mentions": 10,
        "sampleSize": 20,
        "mentionRate": 50,
        "shareOfVoice": 43.47826086956522,
        "previousMentionRate": 40,
        "previousShareOfVoice": 33.33333333333333,
        "configured": true
      },
      {
        "name": "__you__",
        "mentions": 9,
        "sampleSize": 20,
        "mentionRate": 45,
        "shareOfVoice": 39.130434782608695,
        "previousMentionRate": 60,
        "previousShareOfVoice": 50,
        "configured": true
      },
      {
        "name": "Contoso Sound",
        "mentions": 4,
        "sampleSize": 20,
        "mentionRate": 20,
        "shareOfVoice": 17.391304347826086,
        "previousMentionRate": 20,
        "previousShareOfVoice": 16.666666666666664,
        "configured": true
      }
    ],
    "voiceSeries": [
      { "day": "2026-10-16", "name": "__you__", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 41.66666666666667 },
      { "day": "2026-10-16", "name": "Northwind Audio", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 41.66666666666667 },
      { "day": "2026-10-16", "name": "Contoso Sound", "mentions": 2, "runs": 10, "mentionRate": 20, "shareOfVoice": 16.666666666666664 },
      { "day": "2026-10-17", "name": "__you__", "mentions": 4, "runs": 10, "mentionRate": 40, "shareOfVoice": 36.36363636363637 },
      { "day": "2026-10-17", "name": "Northwind Audio", "mentions": 5, "runs": 10, "mentionRate": 50, "shareOfVoice": 45.45454545454545 },
      { "day": "2026-10-17", "name": "Contoso Sound", "mentions": 2, "runs": 10, "mentionRate": 20, "shareOfVoice": 18.181818181818183 }
    ],
    "prompts": [
      {
        "prompt": "are cheap earbuds worth it",
        "runs": 10,
        "mentioned": 3,
        "cited": 0,
        "competitorOnly": 4,
        "mentionRate": 30,
        "citationRate": 0,
        "competitorOnlyRate": 40,
        "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
        "engines": [
          {
            "prompt": "are cheap earbuds worth it",
            "engine": "CHATGPT",
            "runs": 10,
            "mentioned": 3,
            "cited": 0,
            "competitorOnly": 4,
            "mentionRate": 30,
            "citationRate": 0,
            "competitorOnlyRate": 40,
            "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
            "mentionRateChangePp": -20,
            "topCompetitor": "Northwind Audio",
            "topCompetitorRate": 60,
            "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
            "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
            "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63"
          }
        ]
      },
      {
        "prompt": "best wireless earbuds for commuting",
        "runs": 10,
        "mentioned": 6,
        "cited": 3,
        "competitorOnly": 3,
        "mentionRate": 60,
        "citationRate": 30,
        "competitorOnlyRate": 30,
        "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
        "engines": [
          {
            "prompt": "best wireless earbuds for commuting",
            "engine": "CHATGPT",
            "runs": 10,
            "mentioned": 6,
            "cited": 3,
            "competitorOnly": 3,
            "mentionRate": 60,
            "citationRate": 30,
            "competitorOnlyRate": 30,
            "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
            "mentionRateChangePp": -10,
            "topCompetitor": "Northwind Audio",
            "topCompetitorRate": 40,
            "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
            "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
            "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61"
          }
        ]
      }
    ],
    "opportunities": [
      {
        "prompt": "are cheap earbuds worth it",
        "engine": "CHATGPT",
        "runs": 10,
        "mentioned": 3,
        "cited": 0,
        "competitorOnly": 4,
        "mentionRate": 30,
        "citationRate": 0,
        "competitorOnlyRate": 40,
        "previous": { "runs": 10, "mentioned": 5, "cited": 1, "competitorOnly": 3, "mentionRate": 50, "citationRate": 10, "competitorOnlyRate": 30 },
        "mentionRateChangePp": -20,
        "topCompetitor": "Northwind Audio",
        "topCompetitorRate": 60,
        "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
        "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63",
        "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a63"
      },
      {
        "prompt": "best wireless earbuds for commuting",
        "engine": "CHATGPT",
        "runs": 10,
        "mentioned": 6,
        "cited": 3,
        "competitorOnly": 3,
        "mentionRate": 60,
        "citationRate": 30,
        "competitorOnlyRate": 30,
        "previous": { "runs": 10, "mentioned": 7, "cited": 3, "competitorOnly": 2, "mentionRate": 70, "citationRate": 30, "competitorOnlyRate": 20 },
        "mentionRateChangePp": -10,
        "topCompetitor": "Northwind Audio",
        "topCompetitorRate": 40,
        "evidenceTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
        "mentionTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61",
        "latestTaskId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a61"
      }
    ],
    "quality": {
      "comparable": true,
      "comparisonReason": null,
      "scoringVersions": ["3f9a6c1e8b2d4f7a9c0e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a"],
      "noAnswerObservations": 0,
      "unknownObservations": 0,
      "noAnswerIncluded": true,
      "historicalFailures": null,
      "sampleSize": 20,
      "previousSampleSize": 20,
      "configuredCells": 2,
      "observedCells": 2,
      "missingCells": 0,
      "lowSample": true,
      "partialDays": [],
      "denominator": "scored_answers",
      "shareOfVoiceDenominator": "tracked_brand_mentions",
      "trackedBrandMentions": 23,
      "answerTextLimit": 8000,
      "scoring": "collection_time_definitions",
      "failedTasksIncluded": false
    },
    "pauses": [],
    "health": { "completed": 12, "failed": 0, "pending": 0, "topError": null },
    "healthScope": "recent_visible_tasks"
  }
}

읽는 법: 브랜드는 ChatGPT 답변 20개 중 9개(45%)에 언급되었고, 직전 이틀보다 15포인트 낮습니다. Northwind Audio가 더 많은 답변에 언급되었고, 가장 약한 프롬프트는 “are cheap earbuds worth it”으로 브랜드 없이 경쟁사만 언급한 답변이 4개입니다. quality.lowSample이 true이므로 이 변화는 추세가 아니라 확인할 신호로 다루세요.

응답 섹션

필드	내용
`monitor`	저장된 모니터 정의.
`window`	`since`, `until`, `previousSince`, `previousUntil`, `timezone`(`UTC`), `bounds`(`[since, until)`). `previousUntil`은 항상 `since`와 같습니다.
`filters`	적용된 필터를 해석한 값: 정식 엔진 id, 정확한 프롬프트, 또는 `null`.
`stats`, `previous`	이번 기간과 그 이전 기간의 건수와 비율. 비율 객체를 참고하세요.
`changes`	`mentionRatePp`와 `citationRatePp`: 퍼센트포인트 변화량. 비교를 보류하면 `null`.
`engineRates`	엔진별 비율 객체.
`series`	UTC 일자와 엔진별 비율 객체. 기간이 일부만 덮는 날에는 `partial: true`.
`brands`	내 브랜드(`__you__`)와 기간 안에 언급된 모든 경쟁사, 언급 많은 순. 브랜드와 보이스 점유율을 참고하세요.
`voiceSeries`	UTC 일자와 브랜드별 `mentions`, `runs`(그날의 답변 수), `mentionRate`, `shareOfVoice`.
`prompts`	프롬프트별, 언급률 낮은 순: 비율 객체, `previous`, 엔진마다 셀 하나인 `engines`.
`opportunities`	경쟁사는 언급됐는데 내 브랜드는 빠진 셀(`competitorOnly`가 0보다 큼), 그런 답변이 많은 순. 작업할 목록입니다.
`quality`	표본의 구성과 숫자가 말할 수 없는 것. 품질을 참고하세요.
`pauses`	기간과 겹치는 일시정지, 오래된 순: `pausedAt`과 `resumedAt`(일시정지 중이면 `null`).
`health`, `healthScope`	최근 태스크 상태. 리포트와 별개의 범위입니다. 실행 상태를 참고하세요.

비율 객체

stats, previous, 각 engineRates와 series 항목, 각 프롬프트와 각 셀은 같은 필드를 가집니다.

필드	의미
`runs`	채점된 답변 수. 아래 모든 비율의 분모입니다.
`mentioned`	내 브랜드를 언급한 답변.
`cited`	내 도메인 중 하나를 인용한 답변.
`competitorOnly`	경쟁사를 하나 이상 언급하고 내 브랜드는 언급하지 않은 답변.
`mentionRate`, `citationRate`, `competitorOnlyRate`	`100 × count / runs`. `runs`가 0이면 `null`.

셀

셀은 한 엔진에서의 프롬프트 하나입니다. 비율 객체와 previous 외에 다음을 가집니다.

필드	의미
`mentionRateChangePp`	셀의 포인트 변화량. 비교를 보류하면 `null`.
`topCompetitor`	셀의 답변에서 가장 많이 언급된 경쟁사, 또는 `null`.
`topCompetitorRate`	셀에서 그 경쟁사의 언급률. 셀의 일부 답변이 채점 맥락 저장 이전의 것이면 `null`.
`evidenceTaskId`	경쟁사를 언급하고 내 브랜드는 언급하지 않은 최신 답변.
`mentionTaskId`	내 브랜드를 언급한 최신 답변.
`latestTaskId`	최신 답변.

해당하는 답변이 없으면 각 id는 null입니다. GET /v1/monitors/{id}/answers/{taskId}로 여세요.

브랜드와 보이스 점유율

brands의 각 항목에는 name, mentions, sampleSize, mentionRate, shareOfVoice, previousMentionRate, previousShareOfVoice, configured(기간 안에 언급됐지만 더 이상 모니터에 없는 브랜드는 false)가 있습니다.

숫자의 의미

GET /v1/monitors/capabilities가 이 정의를 metrics로 반환하므로 클라이언트가 숫자 옆에 표시할 수 있습니다.

**mentionRate**는 기간, 엔진, 일자, 셀마다 100 × mentioned / 채점된 답변입니다. 엔진별 평균이 아니라 답변 수로 가중하므로, 바쁜 엔진이 한가한 엔진에 묻히지 않습니다.
**citationRate**는 내 도메인 중 하나를 인용한 답변을 같은 방식으로 셉니다. 도메인이 없으면 인용 추적이 꺼져 있으므로 항상 0입니다.
브랜드 비율은 자기 sampleSize로 나눕니다. 내 브랜드는 채점된 모든 답변이고, 경쟁사는 모니터에 등록되어 있던 동안 채점된 답변뿐이므로 오늘 추가한 경쟁사는 오늘부터 측정됩니다. 기간 안의 일부 답변이 채점 맥락 저장 이전에 채점됐다면 무엇과 비교했는지 알 수 없으므로 경쟁사의 mentionRate는 null입니다.
**shareOfVoice**는 기간 안에서 100 × 그 브랜드의 언급 수 / 추적 중인 모든 브랜드 언급 수이므로 한 기간의 점유율을 더하면 100입니다(분모는 quality.trackedBrandMentions). 이 프롬프트로 수집한 답변 안에서 브랜드를 비교하는 값이며, 시장 점유율도 가시성 순위도 아닙니다.
**competitorOnly**와 opportunities는 내 브랜드 없이 경쟁사를 언급한 답변을 셉니다. 실제로 대응할 수 있는 격차입니다.
null은 0이 아닙니다. 나눌 답변이 없으면 비율은 null입니다. 0은 답변이 있었지만 하나도 일치하지 않았다는 뜻입니다.
텍스트 없는 답변은 언급 없음으로 셉니다. 답변 없이 완료된 태스크는 분모에 남고, quality.noAnswerObservations가 그 수를 셉니다. 실패한 태스크는 모든 비율에서 빠지고 health에만 나타납니다. 고장 난 엔진은 부재로 나타나지 않고 표본을 줄입니다.
채점된 답변의 **position**은 내 브랜드가 처음 일치한 곳의 문자 오프셋입니다. 순위가 아니라 노출 정도의 대리 지표입니다. 브랜드가 없으면 null입니다.

변화량을 보류하는 경우

두 기간을 비교할 수 없으면 changes, 각 셀의 mentionRateChangePp, 각 브랜드의 previousMentionRate와 previousShareOfVoice는 null이고 quality.comparable은 false입니다. 이유는 quality.comparisonReason에 있습니다.

`comparisonReason`	의미
`insufficient_periods`	두 기간 중 하나에 답변이 없습니다.
`legacy_scoring_unknown`	일부 답변이 비교 기준 정의가 저장되기 전에 채점됐습니다.
`scoring_definitions_changed`	두 기간의 답변 사이에 별칭, 도메인, 경쟁사, 국가가 바뀌었습니다.

모든 답변은 채점 당시의 정의를 유지하며, quality.scoringVersions는 두 기간에 걸친 서로 다른 정의를 나열합니다(정의가 없는 답변은 legacy). 별칭이나 경쟁사를 바꿔도 과거 답변은 다시 쓰이지 않습니다. 유일한 예외는 주간 경쟁사 분석입니다. 찾아낸 경쟁사가 바뀌면 모니터에 저장된 답변을 새 목록으로 다시 채점합니다.

품질

필드	의미
`comparable`, `comparisonReason`	변화량을 보여 주는지, 보여 주지 않는다면 그 이유.
`scoringVersions`	두 기간에 있는 서로 다른 채점 정의.
`scoring`	항상 `collection_time_definitions`: 답변은 도착 당시의 정의로 채점합니다.
`sampleSize`, `previousSampleSize`	각 기간의 채점된 답변 수.
`lowSample`	기간의 채점된 답변이 30개 미만이면 `true`.
`configuredCells`, `observedCells`, `missingCells`	필터가 덮는 프롬프트 × 엔진 셀, 답변이 하나 이상 있는 셀, 그 차이.
`partialDays`	기간이 잘라 내거나 아직 끝나지 않은 UTC 날짜. 부분 일자의 낮은 건수는 산술 결과이지 하락이 아닙니다.
`noAnswerObservations`	텍스트 없이 완료된 답변. 언급 없음으로 셉니다.
`unknownObservations`	채점 맥락이 저장되기 전에 채점된 답변.
`noAnswerIncluded`, `failedTasksIncluded`, `historicalFailures`	항상 `true`, `false`, `null`: 텍스트 없는 답변은 분모에 들어가고, 실패한 태스크는 들어가지 않으며, 실패를 이력에서 재구성하지 않습니다.
`denominator`, `shareOfVoiceDenominator`	`scored_answers`와 `tracked_brand_mentions`.
`trackedBrandMentions`	보이스 점유율의 분모.
`answerTextLimit`	`8000`: 저장된 답변 텍스트는 8,000자에서 자릅니다.

실행 상태

health에는 진행 중이거나 최근 24시간 안에 끝난 모니터 태스크의 completed, failed, pending, topError(실패한 태스크 중 가장 흔한 오류 코드)가 있습니다. healthScope는 항상 recent_visible_tasks입니다. 기간과 무관한 실행 진단이며 비율의 분모에 들어가지 않습니다.

실행 중 폴링하기

모든 호출은 해당 기간과 필터의 전체 리포트를 반환합니다. 실행이 진행 중일 때는 health.pending이 아직 실행 중인 태스크 수를 셉니다. 0이 되면 리포트를 다시 읽으세요.

카테고리 리포트

카테고리 모니터는 같은 엔드포인트에서 다른 본문을 반환하며, window, filters, quality, pauses, health는 같습니다.

stats와 previous는 runs, named(추적 브랜드를 하나 이상 언급한 답변), namedRate를 담습니다. changes.namedRatePp는 포인트 변화량입니다.
category가 순위를 담습니다.

필드	내용
`category.name`	모니터의 `category`.
`category.brands`	모든 추적 브랜드와 답변이 언급한 모든 브랜드, 언급 많은 순: `name`, `rank`, `mentions`, `sampleSize`, `mentionRate`, `shareOfVoice`, `previousMentionRate`, `previousShareOfVoice`, `changePp`, `configured`.
`category.topics`	세부 분야별 한 행(`topic: null`은 카테고리 전체): `prompts`, `runs`, `named`, `namedRate`, 가장 많이 언급된 브랜드 3곳인 `leaders`.
`category.engines`	기간 안에 답변이 있는 엔진별 한 행: `runs`, `named`, `namedRate`, `leaders`.
`category.series`	UTC 일자별 상위 추적 브랜드 5곳: `mentions`, `sampleSize`, `runs`, `mentionRate`, `partial`.
`category.prompts`	프롬프트별 한 행: `topic`, `retired`(더 이상 모니터에 없는 프롬프트는 `true`), `runs`, `named`, `namedRate`, `leaders`, `engines`. 엔진마다 `runs`, `named`, 브랜드를 언급한 최신 답변의 `evidenceTaskId`가 있습니다.

예를 들어 category.brands 항목 하나는 다음과 같습니다.

{
  "name": "Northwind Sun",
  "mentions": 18,
  "sampleSize": 40,
  "mentionRate": 45,
  "shareOfVoice": 30,
  "previousMentionRate": 40,
  "previousShareOfVoice": 25,
  "changePp": 5,
  "configured": true,
  "rank": 1
}

**rank**는 브랜드를 언급한 답변 수로 순서를 매깁니다. 어느 답변도 언급하지 않은 브랜드는 rank: null입니다.
**mentionRate**는 브랜드 자체의 sampleSize, 즉 브랜드가 목록에 있는 동안 채점된 답변으로 나눕니다.
**shareOfVoice**는 기간 안에서 100 × 그 브랜드의 언급 수 / 모든 브랜드 언급 수이므로 점유율을 더하면 100입니다.

오류와 한도

기간은 최대 90일입니다.
잘못된 파라미터는 문제를 알려 주는 메시지와 함께 400 VALIDATION_ERROR를 반환합니다: since나 until과 함께 쓴 days, since와 until 중 하나만 보냄, 시간대 없는 시각, 90일을 넘는 기간, 미래의 until, 모니터할 수 없는 엔진, 2,000자를 넘는 프롬프트, 반복된 파라미터.
집계하기에 너무 큰 리포트는 “This report is too large”와 함께 400 VALIDATION_ERROR를 반환합니다. 기간, 엔진, 프롬프트를 좁히세요.

모든 모니터 엔드포인트에 공통인 코드는 모니터를 참고하세요.

시작하기

핵심 개념

답변 엔진

검색과 웹 데이터

요청 옵션

리서치

GEO 모니터링

계정과 데이터

모니터 리포트: 언급률, 보이스 점유율, 분석 데이터

쿼리 파라미터

예시

응답 섹션

비율 객체

셀

브랜드와 보이스 점유율

숫자의 의미

변화량을 보류하는 경우

품질

실행 상태

실행 중 폴링하기

카테고리 리포트

오류와 한도

다음 단계

출처와 답변

이벤트와 알림

​쿼리 파라미터

​예시

​응답 섹션

​비율 객체

​셀

​브랜드와 보이스 점유율

​숫자의 의미

​변화량을 보류하는 경우

​품질

​실행 상태

​실행 중 폴링하기

​카테고리 리포트

​오류와 한도

​다음 단계

출처와 답변

이벤트와 알림

쿼리 파라미터

예시

응답 섹션

비율 객체

셀

브랜드와 보이스 점유율

숫자의 의미

변화량을 보류하는 경우

품질

실행 상태

실행 중 폴링하기

카테고리 리포트

오류와 한도

다음 단계