One or more schedulable engines, at most 12. Cannot be empty.
An engine a monitor can schedule: the prompt surfaces sold to customers plus the deprecated NAVER alias. GOOGLE_AIO and GOOGLE_AIMODE are accepted as input aliases and echoed as GOOGLE and AIMODE. CITATION_ANALYSIS is an analysis task, not a prompt surface, and cannot be scheduled on a monitor.
1 to 100 prompts (1,000 on a contract account; capabilities reports yours), each at most 2,000 characters. Do not name your own brand in a prompt: it would always be mentioned and would measure nothing.
BRAND follows one brand and its competitors and needs aliases. CATEGORY follows a market with no brand of its own and needs category. Fixed at creation.
CATEGORY only: maps a prompt (its exact text from prompts) to its sub-field. Up to 30 distinct sub-fields; names that differ only by case are one. A prompt without an entry covers the whole category.
Required for a BRAND monitor: 1 to 20 brand spellings. A CATEGORY monitor has no brand of its own and refuses a value. Short aliases that collide with ordinary words match often - that is the caller's call to make.
Optional. Competitors are found in the monitor's answers after its first run, so list only brands you want tracked from the start or that the read missed: up to 10 on a BRAND monitor and up to 25 on a CATEGORY monitor, where the list is the roster the report ranks, each an object with a name, or the dashboard's one-per-line form Name: alias, alias. Competitor names are matched in the same pass as your own aliases.
Ask every task from this point (ChatGPT, Gemini, Google AI Overview and AI Mode only). Exclusive with grid; setting one clears the other, null asks for the whole country.
Ask every prompt and engine from each point of this grid. Each engine in a run adds prompts × size² × its samples tasks; the first run, which every engine joins, must stay within the account's tasksPerRun limit.
Per-engine cadence and answers per prompt, keyed by engine. An engine without an entry joins every run once. Values equal to the defaults are dropped, and an update that removes an engine removes its entry.
HTTPS URL on a public host that receives change events (see the monitorEvent webhook). Set it with an API key: events are signed with the key that sets it, so sending it again with a new key moves the signing to that key. null turns events off.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"querying.ai","description":"One API for every AI answer engine. Submit a prompt, get the answer and its sources.","colors":{"primary":"#0F766E","light":"#2DD4BF","dark":"#0F766E"},"logo":{"light":"https://mintcdn.com/querying-ai/hbPR_IODrQaVec6W/logo/light.svg?fit=max\u0026auto=format\u0026n=hbPR_IODrQaVec6W\u0026q=85\u0026s=e70eb9454629ff45d5bf908843a393ac","dark":"https://mintcdn.com/querying-ai/hbPR_IODrQaVec6W/logo/dark.svg?fit=max\u0026auto=format\u0026n=hbPR_IODrQaVec6W\u0026q=85\u0026s=41b10775b1a6e4643f03ee42deae6528","href":"https://querying.ai"},"favicon":"https://mintcdn.com/querying-ai/AF1CmtAyu9Rx8OGO/favicon.svg?fit=max\u0026auto=format\u0026n=AF1CmtAyu9Rx8OGO\u0026q=85\u0026s=0fe9e24b5c89f81a4743663007105aee","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"}},"appearance":{"default":"system"},"background":{"color":{"light":"#FFFFFF","dark":"#141414"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://querying.ai/dashboard"}},"seo":{"metatags":{"msvalidate.01":"D437239914CD88705CAB1AC77E85675C","naver-site-verification":"ffb29a85960a4eb3c417886940616c926a99e23a"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"css-variables"},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"toc"},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"ko","href":"ko/introduction"},{"language":"ja","href":"ja/introduction"},{"language":"zh","href":"zh/introduction"},{"language":"es","href":"es/introduction"},{"language":"fr","href":"fr/introduction"},{"language":"de","href":"de/introduction"},{"language":"pt","href":"pt/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"querying-ai","hasAudioNarration":false,"actualSubdomain":"querying-ai","customDomains":["docs.querying.ai"],"gitSource":{"type":"github","owner":"opactor-dev","repo":"querying.ai","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":"","_id":"6adda8bb0fc6acf852ba3694"},"entitlements":{},"buildId":"6af465b46161ed6d3207577f","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"API reference","count":75},{"language":"de","tag":"API-Referenz","count":75},{"language":"es","tag":"Referencia de la API","count":75},{"language":"fr","tag":"Référence de l'API","count":75},{"language":"ja","tag":"APIリファレンス","count":75},{"language":"ko","tag":"API 레퍼런스","count":75},{"language":"pt","tag":"Referência da API","count":75},{"language":"zh","tag":"API 参考","count":75},{"language":"en","tag":"Guides","count":54},{"language":"de","tag":"Leitfäden","count":54},{"language":"es","tag":"Guías","count":54},{"language":"fr","tag":"Guides","count":54},{"language":"ja","tag":"ガイド","count":54},{"language":"ko","tag":"가이드","count":54},{"language":"pt","tag":"Guias","count":54},{"language":"zh","tag":"指南","count":54},{"language":"en","tag":"Monitors","count":22},{"language":"de","tag":"Monitore","count":22},{"language":"es","tag":"Monitores","count":22},{"language":"fr","tag":"Moniteurs","count":22},{"language":"ja","tag":"モニター","count":22},{"language":"ko","tag":"모니터","count":22},{"language":"pt","tag":"Monitores","count":22},{"language":"zh","tag":"监测","count":22},{"language":"en","tag":"Answer engines","count":15},{"language":"de","tag":"Antwort-Engines","count":15},{"language":"es","tag":"Motores de respuesta","count":15},{"language":"fr","tag":"Moteurs de réponse","count":15},{"language":"ja","tag":"回答エンジン","count":15},{"language":"ko","tag":"답변 엔진","count":15},{"language":"pt","tag":"Mecanismos de resposta","count":15},{"language":"zh","tag":"回答引擎","count":15},{"language":"en","tag":"Research","count":13},{"language":"de","tag":"Recherche","count":13},{"language":"es","tag":"Investigación","count":13},{"language":"fr","tag":"Analyses","count":13},{"language":"ja","tag":"リサーチ","count":13},{"language":"ko","tag":"리서치","count":13},{"language":"pt","tag":"Pesquisa","count":13},{"language":"zh","tag":"研究","count":13},{"language":"en","tag":"Operations","count":12},{"language":"en","tag":"Search and web data","count":12},{"language":"de","tag":"Betrieb","count":12},{"language":"de","tag":"Suche und Webdaten","count":12},{"language":"es","tag":"Operaciones","count":12},{"language":"es","tag":"Búsqueda y datos web","count":12},{"language":"fr","tag":"Exploitation","count":12},{"language":"fr","tag":"Recherche et données web","count":12},{"language":"ja","tag":"運用","count":12},{"language":"ja","tag":"検索とウェブデータ","count":12},{"language":"ko","tag":"운영","count":12},{"language":"ko","tag":"검색과 웹 데이터","count":12},{"language":"pt","tag":"Operações","count":12},{"language":"pt","tag":"Busca e dados da web","count":12},{"language":"zh","tag":"运维","count":12},{"language":"zh","tag":"搜索与网页数据","count":12},{"language":"en","tag":"AI Rendering","count":9},{"language":"en","tag":"Sub-accounts","count":9},{"language":"de","tag":"AI Rendering","count":9},{"language":"de","tag":"Unterkonten","count":9},{"language":"es","tag":"AI Rendering","count":9},{"language":"es","tag":"Subcuentas","count":9},{"language":"fr","tag":"AI Rendering","count":9},{"language":"fr","tag":"Sous-comptes","count":9},{"language":"ja","tag":"AI Rendering","count":9},{"language":"ja","tag":"サブアカウント","count":9},{"language":"ko","tag":"AI Rendering","count":9},{"language":"ko","tag":"하위 계정","count":9},{"language":"pt","tag":"AI Rendering","count":9},{"language":"pt","tag":"Subcontas","count":9},{"language":"zh","tag":"AI Rendering","count":9},{"language":"zh","tag":"子账户","count":9},{"language":"en","tag":"Exports","count":8},{"language":"de","tag":"Exporte","count":8},{"language":"es","tag":"Exportaciones","count":8},{"language":"fr","tag":"Exports","count":8},{"language":"ja","tag":"エクスポート","count":8},{"language":"ko","tag":"내보내기","count":8},{"language":"pt","tag":"Exportações","count":8},{"language":"zh","tag":"导出","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:root{--q-sans:\n\t\t-apple-system, BlinkMacSystemFont, \"SF Pro Display\", \"SF Pro Text\", system-ui, \"Segoe UI\", Roboto,\n\t\t\"Apple SD Gothic Neo\", \"Noto Sans KR\", \"Noto Sans CJK KR\", \"Malgun Gothic\", sans-serif;--q-mono: ui-monospace, \"SF Mono\", SFMono-Regular, Menlo, Monaco, Consolas, monospace;--font-inter: var(--q-sans);--font-family-body-custom: var(--q-sans);--font-family-headings-custom: \"Pretendard Variable\", var(--q-sans);--font-paper-mono: var(--q-mono);--gray-50: 250 250 250;--gray-100: 245 245 245;--gray-200: 229 229 229;--gray-300: 212 212 212;--gray-400: 164 164 164;--gray-500: 133 133 133;--gray-600: 102 102 102;--gray-700: 68 68 68;--gray-800: 42 42 44;--gray-900: 22 22 22;--gray-950: 16 16 17;--sidebar-width: 16.5rem;--content-width: 44rem;--q-ink: #161616;--q-text: #161616b8;--q-muted: #161616a3;--q-line: #a4a4a433;--q-fill: #a4a4a40d;--q-fill-strong: #a4a4a41a;--q-card: #fff;--q-well: #fafafa;--q-code: #a4a4a41a;--q-accent: #0f766e;--q-accent-line: #0f766e66;--q-warning: #916200;--q-warning-fill: #da950014;--q-warning-line: #da95003d;--q-negative: #c5293d;--q-negative-fill: #f04c5a14;--q-negative-line: #f04c5a29;--mint-background: var(--q-well);--mint-foreground: #55555c;--mint-token-keyword: #0f766e;--mint-token-string-expression: #161616;--mint-token-string: #6d28d9;--mint-token-function: #6d28d9;--mint-token-constant: #1d4ed8;--mint-token-parameter: #55555c;--mint-token-punctuation: #16161673;--mint-token-comment: #16161680;--mint-token-link: #161616}html.dark{--q-ink: #f2f2f2;--q-text: #9c9c9c;--q-muted: #858585;--q-line: rgb(255 255 255 / 0.08);--q-fill: #fafafa0a;--q-fill-strong: #a4a4a41a;--q-card: #1b1b1d;--q-well: #101011;--q-code: #1b1b1d;--q-accent: #2dd4bf;--q-accent-line: #2dd4bf66;--q-warning: #e9b858;--q-warning-fill: #d2910014;--q-warning-line: #d291003d;--q-negative: #ff7184;--q-negative-fill: #ff435c14;--q-negative-line: #ff435c29;--mint-foreground: #b9b9bf;--mint-token-keyword: #7ee0d3;--mint-token-string-expression: #e7e7e7;--mint-token-string: #c4b5fd;--mint-token-function: #c4b5fd;--mint-token-constant: #93c5fd;--mint-token-parameter: #b9b9bf;--mint-token-punctuation: rgb(242 242 242 / 0.42);--mint-token-comment: rgb(242 242 242 / 0.38);--mint-token-link: #e7e7e7}img.nav-logo{height:20px!important}#navbar{border-bottom:1px solid var(--q-line)}#topbar-cta-button a{height:32px;padding:0 12px;border-radius:8px;background:var(--q-ink)}#topbar-cta-button a,#topbar-cta-button a *{color:rgb(var(--background-light))}.dark #topbar-cta-button a,.dark #topbar-cta-button a *{color:rgb(var(--background-dark))}#sidebar-content{border-right:1px solid var(--q-line)}.sidebar-group-header{color:var(--q-ink);font-size:14px;font-weight:500;letter-spacing:0;text-transform:none}#sidebar-content li>a{border-radius:8px;color:var(--q-text);font-size:14px}#sidebar-content li>a:hover{background:var(--q-fill);color:var(--q-ink)}#sidebar-content li[data-active]>a{background:var(--q-fill-strong);color:var(--q-ink);text-shadow:none}#table-of-contents nav>h2{font-family:inherit}#table-of-contents nav>h2 button{color:var(--q-muted);font-size:13px}#table-of-contents-content{border-left:1px solid var(--q-line)}#table-of-contents div:has(>#table-of-contents-content)>span{left:-0.5px;width:2px;height:20px;border-radius:2px;background:var(--q-ink)}.toc-item>a{color:var(--q-muted)}.toc-item>a:hover,.toc-item[data-active]>a{color:var(--q-ink)}#page-title{color:var(--q-ink);font-size:30px;font-weight:500;line-height:38px;letter-spacing:-0.025em;text-wrap:balance}@media (max-width: 640px){#page-title{font-size:26px;line-height:34px}}#header p{color:var(--q-text);font-size:17px;line-height:27px;text-wrap:balance}.prose{--tw-prose-body: var(--q-text);--tw-prose-headings: var(--q-ink);--tw-prose-lead: var(--q-text);--tw-prose-links: var(--q-accent);--tw-prose-bold: var(--q-ink);--tw-prose-counters: var(--q-muted);--tw-prose-bullets: var(--q-muted);--tw-prose-hr: var(--q-line);--tw-prose-quotes: var(--q-ink);--tw-prose-quote-borders: var(--q-line);--tw-prose-captions: var(--q-muted);--tw-prose-code: var(--q-ink);--tw-prose-th-borders: var(--q-line);--tw-prose-td-borders: var(--q-line)}#content{font-size:16px;line-height:26px}#content :is(p,li){text-wrap:pretty}#content .prose{font-size:inherit;line-height:inherit}#content :is(h2,h3,h4):not([data-component-part]){color:var(--q-ink);font-weight:500;text-wrap:balance}#content h2:not([data-component-part]){margin-top:48px;margin-bottom:12px;font-size:24px;line-height:32px;letter-spacing:-0.02em}#content h3:not([data-component-part]){margin-top:32px;margin-bottom:8px;font-size:18px;line-height:26px;letter-spacing:-0.01em}#content h4:not([data-component-part]){font-size:16px;line-height:24px}#content a.link{border-bottom:0;color:var(--q-accent);font-weight:inherit;text-decoration:underline;text-decoration-color:var(--q-accent-line);text-decoration-thickness:1px;text-underline-offset:3px}#content a.link:hover{text-decoration-color:currentColor}#content :not(pre)>code{padding:1px 6px;border:1px solid var(--q-line);border-radius:6px;background:var(--q-code);color:var(--q-ink);font-size:0.86em;font-weight:400}#content a :not(pre)>code,#content :is(h2,h3,h4) code{color:inherit}#content table{border:1px solid var(--q-line);border-collapse:separate;border-spacing:0;border-radius:10px;font-size:14px;line-height:1.5}#content table :is(th,td){min-width:0}#content table code{word-break:normal;overflow-wrap:break-word}#content table td:first-child code{white-space:nowrap}#content table:has(thead th:nth-child(7)){font-size:13px}#content table:has(thead th:nth-child(7)) :is(th,td){padding-inline:6px}#content thead,#content tbody tr{border-bottom:0}#content thead th{padding:8px 12px;border-bottom:1px solid var(--q-line);background:var(--q-fill);color:var(--q-ink);font-weight:500;vertical-align:bottom}#content thead th:first-child{border-top-left-radius:9px}#content thead th:last-child{border-top-right-radius:9px}#content thead:not(:has(th:not(:empty))){display:none}#content tbody td{padding:8px 12px;border-top:1px solid var(--q-line);vertical-align:top}#content tbody tr:first-child td{border-top:0}:lang(ko) body{word-break:keep-all;overflow-wrap:break-word}:lang(ko) #content{line-height:28px}:is(:lang(ko),:lang(ja),:lang(zh)) #page-title{font-size:28px;line-height:38px;letter-spacing:-0.02em}@media (max-width: 640px){:is(:lang(ko),:lang(ja),:lang(zh)) #page-title{font-size:24px;line-height:32px}}:is(:lang(ko),:lang(ja),:lang(zh)) #content h2:not([data-component-part]){font-size:22px;letter-spacing:-0.01em}:is(:lang(ko),:lang(ja),:lang(zh)) #content h3:not([data-component-part]){letter-spacing:-0.005em}.code-block{border-color:var(--q-line);border-radius:10px}.code-block-background{background:var(--q-well)}html.dark .code-block .code-block-background{background-color:var(--q-well)!important}.code-block pre{font-size:13px;line-height:21px}.code-block-fade-overlay{--fade-color-light: var(--q-well) !important;--fade-color-dark: var(--q-well) !important}.callout{gap:10px;padding:12px 16px;border:1px solid var(--q-line);border-radius:12px;background:var(--q-fill)}#content .callout [data-component-part=\"callout-content\"]{color:var(--q-text);font-size:14px;line-height:22px}.callout [data-component-part=\"callout-icon\"] svg{color:var(--q-muted)}.callout[data-callout-type=\"warning\"]{border-color:var(--q-warning-line);background:var(--q-warning-fill)}.callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:var(--q-warning)}.callout[data-callout-type=\"danger\"]{border-color:var(--q-negative-line);background:var(--q-negative-fill)}.callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:var(--q-negative)}[data-component-part=\"tabs-list\"]{gap:4px;margin-bottom:16px;padding-bottom:0;border-bottom:0}[data-component-part=\"tab-button\"]{margin-bottom:0;padding:4px 10px;border-bottom:0;border-radius:8px;color:var(--q-muted);font-weight:500}[data-component-part=\"tab-button\"]:hover,[data-component-part=\"tab-button\"][data-active=\"true\"]{color:var(--q-ink)}[data-component-part=\"tab-button\"][data-active=\"true\"]{background:var(--q-fill-strong)}.step [data-component-part=\"step-indicator\"]{background:var(--q-fill-strong);color:var(--q-ink);font-size:13px;font-weight:500}.step [data-component-part=\"step-line\"]{background:var(--q-line)}.step [data-component-part=\"step-title\"]{color:var(--q-ink);font-family:var(--font-family-headings-custom);font-size:16px;font-weight:600;letter-spacing:-0.01em}.card{border-color:var(--q-line);border-radius:12px;background:var(--q-card)}#content [data-component-part=\"card-title\"]{color:var(--q-ink);font-size:16px;font-weight:500;letter-spacing:-0.01em}#content [data-component-part=\"card-content\"]{color:var(--q-text);font-size:14px;line-height:22px}.accordion{border-color:var(--q-line);border-radius:12px;background:transparent}.tryit-button{border-radius:8px;background:var(--q-ink);color:rgb(var(--background-light))}.dark .tryit-button{color:rgb(var(--background-dark))}.tryit-button svg{background-color:currentColor}"}],"page":{"pagePath":"fr/api-reference/monitors/create-monitor","slug":"/fr/api-reference/monitors/create-monitor","pageMetadata":{"title":"Créer un moniteur","description":"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.","openapi":"POST /v1/monitors","href":"/fr/api-reference/monitors/create-monitor"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":"css-variables"},"config":{},"pageMetadata":{"title":"Créer un moniteur","description":"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.","openapi":"POST /v1/monitors","href":"/fr/api-reference/monitors/create-monitor"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/querying-ai/50db3c2a8c6df10f/pretendard.js","/_mintlify/custom/querying-ai/076e6719f53a8bea/sidebar-scroll.js"],"openApiReferenceData":{"operation":{"summary":"Create a monitor","operationId":"createMonitor","tags":["Monitors"],"description":"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.","requestBody":"210329c3-aca0-4a96-bdc2-04da4d39b792","responses":{"201":"b6393da2-574b-4968-9e20-68a3963de3ca","400":"03d22518-037e-4f4c-93e4-5417f6289b5d","401":"7bb3cb90-3781-4508-be2f-a0292996935f","403":"fdadfdaa-4dd9-4206-9424-2f3514d2324f","409":"9690d98e-b166-4ea4-af81-4934a149b1a1"},"method":"post","type":"path","servers":["462ecc8c-f044-46ac-8f4c-13d78650f618"],"security":["a1c41455-f788-44eb-8842-53d438024c39"],"path":"/v1/monitors","baseUrlOptions":["https://api.querying.ai"],"title":"Create a monitor","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","engines","prompts","intervalHours"],"properties":{"name":{"type":"string","maxLength":80,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"engines":{"type":"array","items":{"type":"string","description":"An engine a monitor can schedule: the prompt surfaces sold to customers plus the deprecated NAVER alias. GOOGLE_AIO and GOOGLE_AIMODE are accepted as input aliases and echoed as GOOGLE and AIMODE. CITATION_ANALYSIS is an analysis task, not a prompt surface, and cannot be scheduled on a monitor.","enum":["CHATGPT","GEMINI","PERPLEXITY","GOOGLE","AIMODE","NAVER_AI_BRIEF","NAVER_AI_TAB","NAVER"],"uniqueKey":"engines.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"One or more schedulable engines, at most 12. Cannot be empty.","isRequired":true,"uniqueKey":"engines","typeLabel":"enum\u003cstring>[]"},"prompts":{"type":"array","items":{"type":"string","maxLength":2000,"uniqueKey":"prompts.items.[INDEX]","typeLabel":"string"},"description":"1 to 100 prompts (1,000 on a contract account; capabilities reports yours), each at most 2,000 characters. Do not name your own brand in a prompt: it would always be mentioned and would measure nothing.","isRequired":true,"uniqueKey":"prompts","typeLabel":"string[]"},"intervalHours":{"type":"integer","minimum":1,"maximum":168,"isRequired":true,"uniqueKey":"intervalHours","typeLabel":"integer"},"mode":{"type":"string","enum":["BRAND","CATEGORY"],"default":"BRAND","description":"BRAND follows one brand and its competitors and needs aliases. CATEGORY follows a market with no brand of its own and needs category. Fixed at creation.","uniqueKey":"mode","typeLabel":"enum\u003cstring>"},"category":{"type":"string","minLength":1,"maxLength":80,"description":"Required with mode CATEGORY and refused with BRAND: the market the monitor follows, named as a buyer would name it.","uniqueKey":"category","typeLabel":"string"},"promptTopics":{"type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":60,"uniqueKey":"promptTopics.additionalProperties","typeLabel":"string"},"description":"CATEGORY only: maps a prompt (its exact text from prompts) to its sub-field. Up to 30 distinct sub-fields; names that differ only by case are one. A prompt without an entry covers the whole category.","uniqueKey":"promptTopics","typeLabel":"object"},"aliases":{"type":"array","items":{"type":"string","uniqueKey":"aliases.items.[INDEX]","typeLabel":"string"},"description":"Required for a BRAND monitor: 1 to 20 brand spellings. A CATEGORY monitor has no brand of its own and refuses a value. Short aliases that collide with ordinary words match often - that is the caller's call to make.","uniqueKey":"aliases","typeLabel":"string[]"},"domains":{"type":"array","items":{"type":"string","uniqueKey":"domains.items.[INDEX]","typeLabel":"string"},"description":"Up to 20 hosts to track citations for. Defaults to empty (no citation tracking). A CATEGORY monitor refuses a value.","uniqueKey":"domains","typeLabel":"string[]"},"country":{"type":"string","default":"US","description":"Two-letter code. Default US.","uniqueKey":"country","typeLabel":"string"},"competitors":{"oneOf":[{"type":"array","description":"Optional. Competitors are found in the monitor's answers after its first run, so list only brands you want tracked from the start or that the read missed: up to 10 on a BRAND monitor and up to 25 on a CATEGORY monitor, where the list is the roster the report ranks, each an object with a name, or the dashboard's one-per-line form Name: alias, alias. Competitor names are matched in the same pass as your own aliases.","items":{"type":"object","description":"A brand scored alongside yours in the same answers. The name is always one of its own aliases, so a bare name matches reliably.","required":["name"],"properties":{"name":{"type":"string","maxLength":80,"description":"__you__ is reserved for your own brand.","isRequired":true,"uniqueKey":"competitors.oneOf.0.items.[INDEX].name","typeLabel":"string"},"aliases":{"type":"array","maxItems":20,"items":{"type":"string","uniqueKey":"competitors.oneOf.0.items.[INDEX].aliases.items.[INDEX]","typeLabel":"string"},"description":"Other spellings of the same brand. The name is added automatically.","uniqueKey":"competitors.oneOf.0.items.[INDEX].aliases","typeLabel":"string[]"}},"uniqueKey":"competitors.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"competitors.oneOf.0","typeLabel":"object[]"},{"type":"string","description":"Optional. Competitors are found in the monitor's answers after its first run, so list only brands you want tracked from the start or that the read missed: up to 10 on a BRAND monitor and up to 25 on a CATEGORY monitor, where the list is the roster the report ranks, each an object with a name, or the dashboard's one-per-line form Name: alias, alias. Competitor names are matched in the same pass as your own aliases.","items":{"type":"object","description":"A brand scored alongside yours in the same answers. The name is always one of its own aliases, so a bare name matches reliably.","required":["name"],"properties":{"name":{"type":"string","maxLength":80,"description":"__you__ is reserved for your own brand."},"aliases":{"type":"array","maxItems":20,"items":{"type":"string"},"description":"Other spellings of the same brand. The name is added automatically."}}},"uniqueKey":"competitors.oneOf.1","typeLabel":"string"}],"uniqueKey":"competitors","typeLabel":"object[] | string"},"alertBelowPct":{"oneOf":[{"type":"integer","minimum":1,"maximum":100,"description":"Optional mention-rate alert threshold. Omit or null for no alert. A CATEGORY monitor refuses a value.","uniqueKey":"alertBelowPct.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":100,"description":"Optional mention-rate alert threshold. Omit or null for no alert. A CATEGORY monitor refuses a value.","uniqueKey":"alertBelowPct.oneOf.1","typeLabel":"null"}],"uniqueKey":"alertBelowPct","typeLabel":"integer | null"},"location":{"oneOf":[{"type":"object","description":"Ask every task from this point (ChatGPT, Gemini, Google AI Overview and AI Mode only). Exclusive with grid; setting one clears the other, null asks for the whole country.","required":["latitude","longitude"],"example":{"latitude":37.4979,"longitude":127.0276},"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"isRequired":true,"uniqueKey":"location.oneOf.0.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"isRequired":true,"uniqueKey":"location.oneOf.0.longitude","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"location.oneOf.0","typeLabel":"object"},{"type":"null","description":"Ask every task from this point (ChatGPT, Gemini, Google AI Overview and AI Mode only). Exclusive with grid; setting one clears the other, null asks for the whole country.","uniqueKey":"location.oneOf.1","typeLabel":"null"}],"uniqueKey":"location","typeLabel":"object | null"},"grid":{"oneOf":[{"type":"object","description":"Ask every prompt and engine from each point of this grid. Each engine in a run adds prompts × size² × its samples tasks; the first run, which every engine joins, must stay within the account's tasksPerRun limit.","required":["center","size","radiusMeters"],"properties":{"center":{"type":"object","additionalProperties":false,"required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"isRequired":true,"uniqueKey":"grid.oneOf.0.center.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"isRequired":true,"uniqueKey":"grid.oneOf.0.center.longitude","typeLabel":"number"}},"example":{"latitude":37.4979,"longitude":127.0276},"isRequired":true,"uniqueKey":"grid.oneOf.0.center","typeLabel":"object"},"size":{"type":"integer","enum":[3,5,7,9],"description":"Points per side. Odd, so the center is one of the points.","isRequired":true,"uniqueKey":"grid.oneOf.0.size","typeLabel":"enum\u003cinteger>"},"radiusMeters":{"type":"number","minimum":100,"maximum":50000,"description":"Distance from the center to the middle of each edge.","isRequired":true,"uniqueKey":"grid.oneOf.0.radiusMeters","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"grid.oneOf.0","typeLabel":"object"},{"type":"null","description":"Ask every prompt and engine from each point of this grid. Each engine in a run adds prompts × size² × its samples tasks; the first run, which every engine joins, must stay within the account's tasksPerRun limit.","uniqueKey":"grid.oneOf.1","typeLabel":"null"}],"uniqueKey":"grid","typeLabel":"object | null"},"engineSettings":{"type":"object","description":"Per-engine cadence and answers per prompt, keyed by engine. An engine without an entry joins every run once. Values equal to the defaults are dropped, and an update that removes an engine removes its entry.","example":{"CHATGPT":{"samples":5},"GOOGLE":{"intervalHours":168}},"additionalProperties":{"type":"object","additionalProperties":false,"properties":{"intervalHours":{"type":"integer","minimum":1,"maximum":168,"description":"A multiple of the monitor's intervalHours. The engine joins every k-th run, counting from the first run, which every engine joins.","uniqueKey":"engineSettings.additionalProperties.intervalHours","typeLabel":"integer"},"samples":{"type":"integer","minimum":1,"maximum":10,"description":"Answers per prompt and point in each run, each its own task in its own session. Default 1.","uniqueKey":"engineSettings.additionalProperties.samples","typeLabel":"integer"}},"uniqueKey":"engineSettings.additionalProperties","typeLabel":"object"},"uniqueKey":"engineSettings","typeLabel":"object"},"webhookUrl":{"oneOf":[{"type":"string","format":"uri","description":"HTTPS URL on a public host that receives change events (see the monitorEvent webhook). Set it with an API key: events are signed with the key that sets it, so sending it again with a new key moves the signing to that key. null turns events off.","uniqueKey":"webhookUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"HTTPS URL on a public host that receives change events (see the monitorEvent webhook). Set it with an API key: events are signed with the key that sets it, so sending it again with a new key moves the signing to that key. null turns events off.","uniqueKey":"webhookUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhookUrl","typeLabel":"string\u003curi> | null"},"analysis":{"type":"boolean","default":false,"description":"Ask every task for `include.analysis` with this monitor's names, domains and competitors. 1 extra credit per analyzed task.","uniqueKey":"analysis","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"earbuds":{"title":"earbuds","value":{"name":"Earbud brand tracking","engines":["CHATGPT","GEMINI"],"prompts":["best wireless earbuds for commuting"],"aliases":["Acme Audio","Acme"],"domains":["example.com"],"competitors":[{"name":"Sony","aliases":["Sony"]}],"country":"US","intervalHours":24}},"category":{"title":"category","value":{"name":"Sunscreen market","mode":"CATEGORY","category":"Sunscreen","engines":["CHATGPT","GEMINI"],"prompts":["best sunscreen for sensitive skin","best sunscreen for kids"],"promptTopics":{"best sunscreen for sensitive skin":"Sensitive skin","best sunscreen for kids":"Kids"},"competitors":[{"name":"Supergoop"},{"name":"La Roche-Posay","aliases":["LRP"]}],"country":"US","intervalHours":24}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b6393da2-574b-4968-9e20-68a3963de3ca":{"description":"Monitor created and scheduled.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","required":["monitor"],"properties":{"monitor":{"type":"object","description":"One named prompt set in one market, and the schedule that repeats it.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.monitor.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","maxLength":80,"uniqueKey":"data.monitor.name","typeLabel":"string"},"mode":{"type":"string","enum":["BRAND","CATEGORY"],"default":"BRAND","description":"What the monitor measures, fixed at creation. BRAND follows one brand and its competitors. CATEGORY follows a market with no brand of its own and ranks every brand the answers name.","uniqueKey":"data.monitor.mode","typeLabel":"enum\u003cstring>"},"category":{"oneOf":[{"type":"string","maxLength":80,"description":"CATEGORY only: the market the monitor follows. null on a BRAND monitor.","uniqueKey":"data.monitor.category.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":80,"description":"CATEGORY only: the market the monitor follows. null on a BRAND monitor.","uniqueKey":"data.monitor.category.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.category","typeLabel":"string | null"},"promptTopics":{"type":"object","additionalProperties":{"type":"string","maxLength":60,"uniqueKey":"data.monitor.promptTopics.additionalProperties","typeLabel":"string"},"description":"CATEGORY only: each prompt's sub-field, keyed by the prompt's exact text. A prompt without an entry covers the whole category. Empty on a BRAND monitor.","uniqueKey":"data.monitor.promptTopics","typeLabel":"object"},"engines":{"type":"array","items":{"type":"string","description":"An engine a monitor can schedule: the prompt surfaces sold to customers plus the deprecated NAVER alias. GOOGLE_AIO and GOOGLE_AIMODE are accepted as input aliases and echoed as GOOGLE and AIMODE. CITATION_ANALYSIS is an analysis task, not a prompt surface, and cannot be scheduled on a monitor.","enum":["CHATGPT","GEMINI","PERPLEXITY","GOOGLE","AIMODE","NAVER_AI_BRIEF","NAVER_AI_TAB","NAVER"],"uniqueKey":"data.monitor.engines.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Each engine that joins a run submits one task per prompt, per point and per sample.","uniqueKey":"data.monitor.engines","typeLabel":"enum\u003cstring>[]"},"prompts":{"type":"array","items":{"type":"string","maxLength":2000,"uniqueKey":"data.monitor.prompts.items.[INDEX]","typeLabel":"string"},"description":"The exact question texts the monitor asks, stored verbatim. Scored rows are keyed by this text, so editing the list does not rewrite history.","uniqueKey":"data.monitor.prompts","typeLabel":"string[]"},"aliases":{"type":"array","maxItems":20,"items":{"type":"string","uniqueKey":"data.monitor.aliases.items.[INDEX]","typeLabel":"string"},"description":"Spellings of your brand matched against the answer text. Matching ignores case and character width: Latin-script names match whole words, and Korean, Japanese, Chinese and Thai names match anywhere in the text. Empty on a CATEGORY monitor.","uniqueKey":"data.monitor.aliases","typeLabel":"string[]"},"domains":{"type":"array","maxItems":20,"items":{"type":"string","uniqueKey":"data.monitor.domains.items.[INDEX]","typeLabel":"string"},"description":"Hosts matched against the answer citations; a registered domain also matches its subdomains. Empty means citations are not tracked and cited is always false. Always empty on a CATEGORY monitor.","uniqueKey":"data.monitor.domains","typeLabel":"string[]"},"country":{"type":"string","description":"Two-letter country code passed to every task. It selects the market the engines answer for; it does not translate the prompts.","uniqueKey":"data.monitor.country","typeLabel":"string"},"intervalHours":{"type":"integer","minimum":1,"maximum":168,"description":"Hours between scheduled runs.","uniqueKey":"data.monitor.intervalHours","typeLabel":"integer"},"enabled":{"type":"boolean","description":"false pauses the schedule without deleting the monitor or its history.","uniqueKey":"data.monitor.enabled","typeLabel":"boolean"},"alertBelowPct":{"oneOf":[{"type":"integer","minimum":1,"maximum":100,"description":"Email when the recent mention rate falls below this percentage. null means the alert is off, and it is always null on a CATEGORY monitor.","uniqueKey":"data.monitor.alertBelowPct.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":100,"description":"Email when the recent mention rate falls below this percentage. null means the alert is off, and it is always null on a CATEGORY monitor.","uniqueKey":"data.monitor.alertBelowPct.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.alertBelowPct","typeLabel":"integer | null"},"competitors":{"type":"array","maxItems":50,"description":"BRAND: up to 10 you added, then up to 15 the competitor read found in this monitor's answers. CATEGORY: up to 25 you added, then up to 25 the read found, and the whole list is the roster the report ranks.","items":{"type":"object","description":"A brand scored alongside yours in the same answers. The name is always one of its own aliases, so a bare name matches reliably.","required":["name"],"properties":{"name":{"type":"string","maxLength":80,"description":"__you__ is reserved for your own brand.","isRequired":true,"uniqueKey":"data.monitor.competitors.items.[INDEX].name","typeLabel":"string"},"aliases":{"type":"array","maxItems":20,"items":{"type":"string","uniqueKey":"data.monitor.competitors.items.[INDEX].aliases.items.[INDEX]","typeLabel":"string"},"description":"Other spellings of the same brand. The name is added automatically.","uniqueKey":"data.monitor.competitors.items.[INDEX].aliases","typeLabel":"string[]"},"source":{"type":"string","enum":["user","auto"],"readOnly":true,"description":"user: you added it. auto: the weekly competitor read found it in the monitor's own answers. Entries you send with source auto are ignored, so a monitor read and written back keeps its found competitors.","uniqueKey":"data.monitor.competitors.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"domain":{"type":"string","readOnly":true,"description":"The competitor's site, when the competitor read found one.","uniqueKey":"data.monitor.competitors.items.[INDEX].domain","typeLabel":"string"}},"uniqueKey":"data.monitor.competitors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.monitor.competitors","typeLabel":"object[]"},"competitorsReadAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the competitor read last ran. It runs once the first run is in, then every 7 days when the monitor has run since. null until then.","uniqueKey":"data.monitor.competitorsReadAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the competitor read last ran. It runs once the first run is in, then every 7 days when the monitor has run since. null until then.","uniqueKey":"data.monitor.competitorsReadAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.competitorsReadAt","typeLabel":"string\u003cdate-time> | null"},"nextRunAt":{"type":"string","format":"date-time","description":"When the next run becomes due. A run is admitted by the next sweep tick, not at this instant.","uniqueKey":"data.monitor.nextRunAt","typeLabel":"string\u003cdate-time>"},"lastRunAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.monitor.lastRunAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.monitor.lastRunAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.lastRunAt","typeLabel":"string\u003cdate-time> | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.monitor.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.monitor.updatedAt","typeLabel":"string\u003cdate-time>"},"location":{"oneOf":[{"type":"object","description":"Ask every task from this point (ChatGPT, Gemini, Google AI Overview and AI Mode only). Exclusive with grid; setting one clears the other, null asks for the whole country.","required":["latitude","longitude"],"example":{"latitude":37.4979,"longitude":127.0276},"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"isRequired":true,"uniqueKey":"data.monitor.location.oneOf.0.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"isRequired":true,"uniqueKey":"data.monitor.location.oneOf.0.longitude","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.monitor.location.oneOf.0","typeLabel":"object"},{"type":"null","description":"Ask every task from this point (ChatGPT, Gemini, Google AI Overview and AI Mode only). Exclusive with grid; setting one clears the other, null asks for the whole country.","uniqueKey":"data.monitor.location.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.location","typeLabel":"object | null"},"grid":{"oneOf":[{"type":"object","description":"Ask every prompt and engine from each point of this grid. Each engine in a run adds prompts × size² × its samples tasks; the first run, which every engine joins, must stay within the account's tasksPerRun limit.","required":["center","size","radiusMeters"],"properties":{"center":{"type":"object","additionalProperties":false,"required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"isRequired":true,"uniqueKey":"data.monitor.grid.oneOf.0.center.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"isRequired":true,"uniqueKey":"data.monitor.grid.oneOf.0.center.longitude","typeLabel":"number"}},"example":{"latitude":37.4979,"longitude":127.0276},"isRequired":true,"uniqueKey":"data.monitor.grid.oneOf.0.center","typeLabel":"object"},"size":{"type":"integer","enum":[3,5,7,9],"description":"Points per side. Odd, so the center is one of the points.","isRequired":true,"uniqueKey":"data.monitor.grid.oneOf.0.size","typeLabel":"enum\u003cinteger>"},"radiusMeters":{"type":"number","minimum":100,"maximum":50000,"description":"Distance from the center to the middle of each edge.","isRequired":true,"uniqueKey":"data.monitor.grid.oneOf.0.radiusMeters","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"data.monitor.grid.oneOf.0","typeLabel":"object"},{"type":"null","description":"Ask every prompt and engine from each point of this grid. Each engine in a run adds prompts × size² × its samples tasks; the first run, which every engine joins, must stay within the account's tasksPerRun limit.","uniqueKey":"data.monitor.grid.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.grid","typeLabel":"object | null"},"engineSettings":{"type":"object","description":"Per-engine cadence and answers per prompt, keyed by engine. An engine without an entry joins every run once. Values equal to the defaults are dropped, and an update that removes an engine removes its entry.","example":{"CHATGPT":{"samples":5},"GOOGLE":{"intervalHours":168}},"additionalProperties":{"type":"object","additionalProperties":false,"properties":{"intervalHours":{"type":"integer","minimum":1,"maximum":168,"description":"A multiple of the monitor's intervalHours. The engine joins every k-th run, counting from the first run, which every engine joins.","uniqueKey":"data.monitor.engineSettings.additionalProperties.intervalHours","typeLabel":"integer"},"samples":{"type":"integer","minimum":1,"maximum":10,"description":"Answers per prompt and point in each run, each its own task in its own session. Default 1.","uniqueKey":"data.monitor.engineSettings.additionalProperties.samples","typeLabel":"integer"}},"uniqueKey":"data.monitor.engineSettings.additionalProperties","typeLabel":"object"},"uniqueKey":"data.monitor.engineSettings","typeLabel":"object"},"webhookUrl":{"oneOf":[{"type":"string","description":"Where change events are posted, or null when they are off.","uniqueKey":"data.monitor.webhookUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Where change events are posted, or null when they are off.","uniqueKey":"data.monitor.webhookUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.monitor.webhookUrl","typeLabel":"string | null"},"analysis":{"type":"boolean","description":"Ask every task for `include.analysis` with this monitor's names, domains and competitors. 1 extra credit per analyzed task.","uniqueKey":"data.monitor.analysis","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data.monitor","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"monitor":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","mode":"BRAND","category":"\u003cstring>","promptTopics":{},"engines":["CHATGPT"],"prompts":["\u003cstring>"],"aliases":["\u003cstring>"],"domains":["\u003cstring>"],"country":"\u003cstring>","intervalHours":84,"enabled":true,"alertBelowPct":50,"competitors":[{"name":"\u003cstring>","aliases":["\u003cstring>"],"source":"user","domain":"\u003cstring>"}],"competitorsReadAt":"2023-11-07T05:31:56Z","nextRunAt":"2023-11-07T05:31:56Z","lastRunAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","location":{"latitude":37.4979,"longitude":127.0276},"grid":{"center":{"latitude":37.4979,"longitude":127.0276},"size":3,"radiusMeters":25050},"engineSettings":{"CHATGPT":{"samples":5},"GOOGLE":{"intervalHours":168}},"webhookUrl":"\u003cstring>","analysis":true}}}}},"exampleType":"generated"}},"exampleType":"generated"},"03d22518-037e-4f4c-93e4-5417f6289b5d":{"description":"The request is malformed: bad JSON, unrecognised `taskType`, or neither `payload.prompt` nor `payload.query` present. `details` names the offending field.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, safe to branch on. See the Errors guide for the full list.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans. May change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"type":"object","description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","additionalProperties":true,"uniqueKey":"error.details.oneOf.1","typeLabel":"object"}],"uniqueKey":"error.details","typeLabel":"object[] | object"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingPrompt":{"title":"missingPrompt","value":{"success":false,"error":{"code":"VALIDATION_ERROR","message":"Request validation failed","details":[{"field":"payload.prompt","message":"payload.prompt or payload.query is required"}],"timestamp":"2026-07-09T04:12:00.000Z"}}},"badTaskType":{"title":"badTaskType","value":{"success":false,"error":{"code":"VALIDATION_ERROR","message":"Request validation failed","details":[{"field":"taskType","message":"'NOPE' is not recognized"}],"timestamp":"2026-07-09T04:12:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"7bb3cb90-3781-4508-be2f-a0292996935f":{"description":"Missing or invalid bearer token.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, safe to branch on. See the Errors guide for the full list.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans. May change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"type":"object","description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","additionalProperties":true,"uniqueKey":"error.details.oneOf.1","typeLabel":"object"}],"uniqueKey":"error.details","typeLabel":"object[] | object"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"MISSING_API_KEY","message":"Missing or invalid API key","timestamp":"2026-07-09T04:12:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"MISSING_API_KEY","message":"Missing or invalid API key","timestamp":"2026-07-09T04:12:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"fdadfdaa-4dd9-4206-9424-2f3514d2324f":{"description":"The key is restricted to some engines (allowedTaskTypes) and the monitor schedules an engine outside that list. The scope that applies to POST /v1/async/task also applies to monitors, or a schedule would be a way around it.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, safe to branch on. See the Errors guide for the full list.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans. May change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"type":"object","description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","additionalProperties":true,"uniqueKey":"error.details.oneOf.1","typeLabel":"object"}],"uniqueKey":"error.details","typeLabel":"object[] | object"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"KEY_SCOPE_DENIED","message":"This key is not allowed to use engine GEMINI","timestamp":"2026-09-22T04:12:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"KEY_SCOPE_DENIED","message":"This key is not allowed to use engine GEMINI","timestamp":"2026-09-22T04:12:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9690d98e-b166-4ea4-af81-4934a149b1a1":{"description":"The account already holds the maximum number of monitors. Delete one before creating another.","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, safe to branch on. See the Errors guide for the full list.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"For humans. May change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.details.oneOf.0.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","uniqueKey":"error.details.oneOf.0","typeLabel":"object[]"},{"type":"object","description":"Context for the error. An array of `{field, message}` on most `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted when there is nothing to add.","additionalProperties":true,"uniqueKey":"error.details.oneOf.1","typeLabel":"object"}],"uniqueKey":"error.details","typeLabel":"object[] | object"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"MONITOR_LIMIT","message":"Max 20 monitors. Delete one first.","timestamp":"2026-09-22T04:12:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"MONITOR_LIMIT","message":"Max 20 monitors. Delete one first.","timestamp":"2026-09-22T04:12:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a1c41455-f788-44eb-8842-53d438024c39":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key, sent as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"462ecc8c-f044-46ac-8f4c-13d78650f618":{"url":"https://api.querying.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key, sent as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key, sent as `Authorization: Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"querying-ai","siteName":"querying.ai","title":"Créer un moniteur - querying.ai","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/monitors/create-monitor","matchLevel":1},"ko":{"href":"/ko/api-reference/monitors/create-monitor","matchLevel":1},"ja":{"href":"/ja/api-reference/monitors/create-monitor","matchLevel":1},"zh":{"href":"/zh/api-reference/monitors/create-monitor","matchLevel":1},"es":{"href":"/es/api-reference/monitors/create-monitor","matchLevel":1},"fr":{"href":"/fr/api-reference/monitors/create-monitor","matchLevel":0},"de":{"href":"/de/api-reference/monitors/create-monitor","matchLevel":1},"pt":{"href":"/pt/api-reference/monitors/create-monitor","matchLevel":1}}},"lastModified":"2026-10-19T12:56:26.003Z","originalFileLocation":"fr/api-reference/monitors/create-monitor.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\">\u003cmeta data-mint-head name=\"application-name\" content=\"querying.ai\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Créer un moniteur - querying.ai\">\u003cmeta data-mint-head property=\"og:description\" content=\"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"querying.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://querying-ai.mintlify.site/_mintlify/api/og/v2?division=Moniteurs\u0026amp;title=Cr%C3%A9er+un+moniteur\u0026amp;description=Enregistrez+un+ensemble+nomm%C3%A9+de+prompts+sur+un+march%C3%A9+et+lancez+sa+planification.\u0026amp;theme=a594992072db4a12a05c91e2\u0026amp;signature=cff8e4de1c3fb6bd43b77801312ee0c279a2fd469eeb81265f0dc4655b2b214f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Créer un moniteur - querying.ai\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://querying-ai.mintlify.site/_mintlify/api/og/v2?division=Moniteurs\u0026amp;title=Cr%C3%A9er+un+moniteur\u0026amp;description=Enregistrez+un+ensemble+nomm%C3%A9+de+prompts+sur+un+march%C3%A9+et+lancez+sa+planification.\u0026amp;theme=a594992072db4a12a05c91e2\u0026amp;signature=cff8e4de1c3fb6bd43b77801312ee0c279a2fd469eeb81265f0dc4655b2b214f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/querying-ai/aFfd7aZ8B1gAGQVl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"querying.ai\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"D437239914CD88705CAB1AC77E85675C\">\u003cmeta data-mint-head name=\"naver-site-verification\" content=\"ffb29a85960a4eb3c417886940616c926a99e23a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fr/api-reference/monitors/create-monitor.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.querying.ai/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.querying.ai/ko/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.querying.ai/ja/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.querying.ai/zh/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.querying.ai/es/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.querying.ai/de/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.querying.ai/pt/api-reference/monitors/create-monitor\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.querying.ai/api-reference/monitors/create-monitor\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.querying.ai/#organization\",\"name\":\"querying.ai\",\"url\":\"https://docs.querying.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/querying-ai/hbPR_IODrQaVec6W/logo/light.svg?fit=max\u0026auto=format\u0026n=hbPR_IODrQaVec6W\u0026q=85\u0026s=e70eb9454629ff45d5bf908843a393ac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.querying.ai#website\",\"name\":\"querying.ai\",\"url\":\"https://docs.querying.ai\",\"publisher\":{\"@id\":\"https://docs.querying.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor#webpage\",\"url\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\",\"name\":\"Créer un moniteur\",\"description\":\"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\",\"dateModified\":\"2026-10-19T12:56:26.003Z\",\"isPartOf\":{\"@id\":\"https://docs.querying.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Moniteurs\",\"item\":\"https://docs.querying.ai/fr/api-reference/monitors/list-monitors\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Créer un moniteur\",\"item\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor#apireference\",\"headline\":\"Créer un moniteur\",\"name\":\"Créer un moniteur\",\"description\":\"Enregistrez un ensemble nommé de prompts sur un marché et lancez sa planification.\",\"url\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor\",\"mainEntityOfPage\":{\"@id\":\"https://docs.querying.ai/fr/api-reference/monitors/create-monitor#webpage\"},\"dateModified\":\"2026-10-19T12:56:26.003Z\",\"publisher\":{\"@id\":\"https://docs.querying.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.querying.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"querying.ai\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"querying.ai\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/fr/api-reference/monitors/create-monitor.md","siteName":"querying.ai","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/monitors/create-monitor"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/monitors/create-monitor"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/api-reference/monitors/create-monitor"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/monitors/create-monitor"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/monitors/create-monitor"}]},{"language":"fr","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/fr/introduction"}]},{"tab":"Référence de l'API","groups":[{"group":"Tâches","pages":[{"title":"Créer une tâche","openapi":"POST /v1/async/task","href":"/fr/api-reference/create-task"},{"title":"Obtenir une tâche","openapi":"GET /v1/async/task/{id}","href":"/fr/api-reference/get-task"},{"title":"Créer des tâches en masse","openapi":"POST /v1/async/task/batch","href":"/fr/api-reference/create-task-batch"}]},{"group":"Lots","pages":[{"title":"Créer un lot","openapi":"POST /v1/batches","href":"/fr/api-reference/create-batch"},{"title":"Obtenir un lot","openapi":"GET /v1/batches/{id}","href":"/fr/api-reference/get-batch"},{"title":"Lister les éléments d’un lot","openapi":"GET /v1/batches/{id}/items","href":"/fr/api-reference/list-batch-items"}]},{"group":"Grilles de localisation","pages":[{"title":"Créer une grille de lieux","openapi":"POST /v1/async/task/grid","href":"/fr/api-reference/create-task-grid"},{"title":"Lire une grille de lieux","openapi":"GET /v1/async/task/grid/{id}","href":"/fr/api-reference/get-task-grid"}]},{"group":"Analyses","pages":[{"title":"Citation Analysis","openapi":"post /v1/citation-analysis","href":"/fr/api-reference/citation-analysis"},{"title":"Prompt Research","openapi":"POST /v1/prompt-research","href":"/fr/api-reference/prompt-research"},{"title":"GEO Score","openapi":"POST /v1/geo-score","href":"/fr/api-reference/geo-score"},{"title":"Product Lookup","openapi":"POST /v1/product-lookup","href":"/fr/api-reference/product-lookup"},{"title":"Lire un Product Lookup","openapi":"GET /v1/product-lookup/{id}","href":"/fr/api-reference/get-product-lookup"},{"title":"Créer un Place Lookup","openapi":"POST /v1/place-lookup","href":"/fr/api-reference/place-lookup"},{"title":"Lire un Place Lookup","openapi":"GET /v1/place-lookup/{id}","href":"/fr/api-reference/get-place-lookup"}]},{"group":"AI Rendering","pages":[{"title":"Lister les sites","openapi":"GET /v1/ai-rendering/sites","href":"/fr/api-reference/ai-rendering/list-sites"},{"title":"Connecter un site","openapi":"POST /v1/ai-rendering/sites","href":"/fr/api-reference/ai-rendering/create-site"},{"title":"Obtenir un site","openapi":"GET /v1/ai-rendering/sites/{id}","href":"/fr/api-reference/ai-rendering/get-site"},{"title":"Modifier un site","openapi":"PATCH /v1/ai-rendering/sites/{id}","href":"/fr/api-reference/ai-rendering/update-site"},{"title":"Supprimer un site","openapi":"DELETE /v1/ai-rendering/sites/{id}","href":"/fr/api-reference/ai-rendering/delete-site"},{"title":"Nouvelle clé de site","openapi":"POST /v1/ai-rendering/sites/{id}/key","href":"/fr/api-reference/ai-rendering/rotate-key"},{"title":"Publier une page","openapi":"POST /v1/ai-rendering/sites/{id}/pages","href":"/fr/api-reference/ai-rendering/publish-page"},{"title":"Retirer une page","openapi":"DELETE /v1/ai-rendering/sites/{id}/pages/{pageId}","href":"/fr/api-reference/ai-rendering/delete-page"},{"title":"Lister les copies d'un site","openapi":"GET /v1/ai-rendering/copies","href":"/fr/api-reference/ai-rendering/list-copies"}]},{"group":"Moniteurs","pages":[{"title":"Lister les moniteurs","description":"Listez tous les moniteurs de la clé, du plus récent au plus ancien.","openapi":"GET /v1/monitors","href":"/fr/api-reference/monitors/list-monitors"},{"title":"Créer un moniteur","openapi":"POST /v1/monitors","href":"/fr/api-reference/monitors/create-monitor"},{"title":"Obtenir un moniteur","description":"Lisez la définition d’un moniteur avec le détail par période qu’affiche la vue d’ensemble du tableau de bord.","openapi":"GET /v1/monitors/{id}","href":"/fr/api-reference/monitors/get-monitor"},{"title":"Modifier un moniteur","openapi":"PATCH /v1/monitors/{id}","href":"/fr/api-reference/monitors/update-monitor"},{"title":"Supprimer un moniteur","openapi":"DELETE /v1/monitors/{id}","href":"/fr/api-reference/monitors/delete-monitor"},{"title":"Exécuter un moniteur maintenant","openapi":"POST /v1/monitors/{id}/run","href":"/fr/api-reference/monitors/run-monitor"},{"title":"Obtenir les analyses d’un moniteur","openapi":"GET /v1/monitors/{id}/analytics","href":"/fr/api-reference/monitors/get-analytics"},{"title":"Lister les sources citées","openapi":"GET /v1/monitors/{id}/sources","href":"/fr/api-reference/monitors/list-sources"},{"title":"Obtenir les citations dans le temps","openapi":"GET /v1/monitors/{id}/citations","href":"/fr/api-reference/monitors/get-citations"},{"title":"Obtenir une réponse notée","openapi":"GET /v1/monitors/{id}/answers/{taskId}","href":"/fr/api-reference/monitors/get-answer"},{"title":"Obtenir un prompt","openapi":"GET /v1/monitors/{id}/prompt","href":"/fr/api-reference/monitors/get-prompt"},{"title":"Exporter les réponses notées","openapi":"GET /v1/monitors/{id}/results","href":"/fr/api-reference/monitors/export-results"},{"title":"Obtenir les réponses d’un moniteur par lieu","openapi":"GET /v1/monitors/{id}/grid","href":"/fr/api-reference/monitors/get-grid"},{"title":"Lister les événements de changement","openapi":"GET /v1/monitors/{id}/events","href":"/fr/api-reference/monitors/list-events"},{"title":"Relivrer un événement de changement","openapi":"POST /v1/monitors/{id}/events/{eventId}/redeliver","href":"/fr/api-reference/monitors/redeliver-event"},{"title":"Obtenir l’historique des alertes","openapi":"GET /v1/monitors/{id}/alerts","href":"/fr/api-reference/monitors/get-alerts"},{"title":"Envoyer une alerte de test","openapi":"POST /v1/monitors/{id}/alerts/test","href":"/fr/api-reference/monitors/test-alert"},{"title":"Obtenir les capacités des moniteurs","openapi":"GET /v1/monitors/capabilities","href":"/fr/api-reference/monitors/get-capabilities"},{"title":"Suggérer des prompts","openapi":"POST /v1/monitors/suggest","href":"/fr/api-reference/monitors/suggest-prompts"},{"title":"Rechercher des prompts pour un moniteur","openapi":"POST /v1/monitors/research","href":"/fr/api-reference/monitors/research-prompts"},{"title":"Obtenir le partage du rapport","openapi":"GET /v1/monitors/{id}/share","href":"/fr/api-reference/monitors/get-share"},{"title":"Partager un rapport","openapi":"PUT /v1/monitors/{id}/share","href":"/fr/api-reference/monitors/update-share"}]},{"group":"Exports","pages":[{"title":"Lister les exports","openapi":"GET /v1/exports","href":"/fr/api-reference/exports/list-exports"},{"title":"Créer un export","openapi":"POST /v1/exports","href":"/fr/api-reference/exports/create-export"},{"title":"Obtenir l’identité d’export","openapi":"GET /v1/exports/identity","href":"/fr/api-reference/exports/get-identity"},{"title":"Obtenir un export","openapi":"GET /v1/exports/{id}","href":"/fr/api-reference/exports/get-export"},{"title":"Suspendre ou reprendre un export","openapi":"PATCH /v1/exports/{id}","href":"/fr/api-reference/exports/update-export"},{"title":"Supprimer un export","openapi":"DELETE /v1/exports/{id}","href":"/fr/api-reference/exports/delete-export"},{"title":"Lister l’historique des livraisons","openapi":"GET /v1/exports/{id}/runs","href":"/fr/api-reference/exports/list-runs"},{"title":"Relancer une fenêtre de livraison","openapi":"POST /v1/exports/{id}/runs/{runId}/retry","href":"/fr/api-reference/exports/retry-run"}]},{"group":"Sous-comptes","pages":[{"title":"Lister les sous-comptes","openapi":"GET /v1/sub-accounts","href":"/fr/api-reference/sub-accounts/list-sub-accounts"},{"title":"Créer un sous-compte","openapi":"POST /v1/sub-accounts","href":"/fr/api-reference/sub-accounts/create-sub-account"},{"title":"Obtenir un sous-compte","openapi":"GET /v1/sub-accounts/{id}","href":"/fr/api-reference/sub-accounts/get-sub-account"},{"title":"Modifier ou suspendre un sous-compte","openapi":"PATCH /v1/sub-accounts/{id}","href":"/fr/api-reference/sub-accounts/update-sub-account"},{"title":"Lister les clés d’un sous-compte","openapi":"GET /v1/sub-accounts/{id}/keys","href":"/fr/api-reference/sub-accounts/list-keys"},{"title":"Émettre une clé de sous-compte","openapi":"POST /v1/sub-accounts/{id}/keys","href":"/fr/api-reference/sub-accounts/issue-key"},{"title":"Révoquer une clé de sous-compte","openapi":"DELETE /v1/sub-accounts/{id}/keys/{keyId}","href":"/fr/api-reference/sub-accounts/revoke-key"},{"title":"Obtenir la consommation d’un sous-compte","openapi":"GET /v1/sub-accounts/{id}/usage","href":"/fr/api-reference/sub-accounts/get-usage"},{"title":"Lister la consommation de tous les sous-comptes","openapi":"GET /v1/sub-accounts/usage","href":"/fr/api-reference/sub-accounts/list-usage"}]},{"group":"Exploitation","pages":[{"title":"Capacités des moteurs","openapi":"GET /v1/capabilities","href":"/fr/api-reference/capabilities"},{"title":"Liste des pays","openapi":"GET /v1/countries","href":"/fr/api-reference/countries"},{"title":"Liste des États","openapi":"GET /v1/states","href":"/fr/api-reference/states"},{"title":"Solde de crédits","openapi":"GET /v1/credits","href":"/fr/api-reference/credits"},{"title":"Utilisation des crédits","openapi":"GET /v1/usage","href":"/fr/api-reference/usage"},{"title":"État de la file","openapi":"GET /v1/async/status","href":"/fr/api-reference/queue-status"},{"title":"Résoudre une redirection Google","openapi":"POST /v1/google/goto","href":"/fr/api-reference/google-goto"},{"title":"Vider la file","openapi":"DELETE /v1/async/queue","href":"/fr/api-reference/clear-queue"},{"title":"Sonde de liveness","openapi":"GET /health","href":"/fr/api-reference/health"},{"title":"Sonde de readiness","openapi":"GET /ready","href":"/fr/api-reference/ready"},{"title":"Nombre de tâches de votre compte","sidebarTitle":"Statistiques","openapi":"GET /stats","href":"/fr/api-reference/stats"},{"title":"Mode de service ChatGPT","sidebarTitle":"Capacité","openapi":"GET /capacity","href":"/fr/api-reference/capacity"}]}]}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/monitors/create-monitor"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/api-reference/monitors/create-monitor"}]}]},"basePath":"","title":"Créer un moniteur - querying.ai","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C4GwDT3_.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}