Your API key, sent as Authorization: Bearer <key>.
경로 매개변수
id
string<uuid>
필수
The task id returned at submit time.
응답
The task, plus response or error once terminal.
success
boolean
필수
task
object
필수
Show child attributes
credits
object
필수
Credits, with up to two decimals (for example 1.25). The submit response always shows 0: nothing is charged yet, and the task's price is held from your balance when it starts. Polling shows 0 until the task is terminal, then the settled charge: the task's price for COMPLETED, 0 for FAILED. A task webhook reports the same charge in creditsCharged; on a FAILED task it reports the task's price in creditsToCharge and 0 in creditsCharged. CITATION_ANALYSIS, GOOGLE_PLACES and GOOGLE_NEWS are charged by usage, up to the hold placed when the task starts.
Show child attributes
response
object
The engine-specific result. Absent until the task is terminal. See the Engines guide for per-engine shapes. NAVER_AI_TAB preserves the original text, markdown, sources and cards when Naver returns HTTP success, a valid stream ending in done, and nonempty answer text with unknown_error. It includes upstreamError and returns immediately without retrying or rephrasing, even with retryQuery. COMPLETED means collection finished; the answer may still be incomplete. Empty, cut-off or malformed streams still fail. Policy refusals complete with a policy_declined notice. rawContent is returned only with include.rawResponse. With include.citationAnalysis, answer results also carry citationAnalysis (see Include). CITATION_ANALYSIS returns CitationAnalysisResult; see the Citation Analysis guide. PROMPT_RESEARCH returns PromptResearchResult; see the Prompt Research guide. GEO_SCORE returns GeoScoreResult; see the GEO Score guide. Answer engines with include.analysis add analysis (AnswerAnalysis).
Show child attributes
error
string
Present when task.status is FAILED. A plain string, not the {code, message, timestamp} object used by request-level errors.
{"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/7nShuIBsrfw0VD3y/favicon.svg?fit=max\u0026auto=format\u0026n=7nShuIBsrfw0VD3y\u0026q=85\u0026s=1a52a70c832728a9f4fb1fcf690fdf9d","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":"6aff270ca7bd692b3fa066af","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"API reference","count":84},{"language":"de","tag":"API-Referenz","count":84},{"language":"es","tag":"Referencia de la API","count":84},{"language":"fr","tag":"Référence de l'API","count":84},{"language":"ja","tag":"APIリファレンス","count":84},{"language":"ko","tag":"API 레퍼런스","count":84},{"language":"pt","tag":"Referência da API","count":84},{"language":"zh","tag":"API 参考","count":84},{"language":"en","tag":"Guides","count":49},{"language":"de","tag":"Leitfäden","count":49},{"language":"es","tag":"Guías","count":49},{"language":"fr","tag":"Guides","count":49},{"language":"ja","tag":"ガイド","count":49},{"language":"ko","tag":"가이드","count":49},{"language":"pt","tag":"Guias","count":49},{"language":"zh","tag":"指南","count":49},{"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":"AI Rendering","count":19},{"language":"de","tag":"AI Rendering","count":19},{"language":"es","tag":"AI Rendering","count":19},{"language":"fr","tag":"AI Rendering","count":19},{"language":"ja","tag":"AI Rendering","count":19},{"language":"ko","tag":"AI Rendering","count":19},{"language":"pt","tag":"AI Rendering","count":19},{"language":"zh","tag":"AI Rendering","count":19},{"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":"Operations","count":12},{"language":"de","tag":"Betrieb","count":12},{"language":"es","tag":"Operaciones","count":12},{"language":"fr","tag":"Exploitation","count":12},{"language":"ja","tag":"運用","count":12},{"language":"ko","tag":"운영","count":12},{"language":"pt","tag":"Operações","count":12},{"language":"zh","tag":"运维","count":12},{"language":"en","tag":"Sub-accounts","count":9},{"language":"de","tag":"Unterkonten","count":9},{"language":"es","tag":"Subcuentas","count":9},{"language":"fr","tag":"Sous-comptes","count":9},{"language":"ja","tag":"サブアカウント","count":9},{"language":"ko","tag":"하위 계정","count":9},{"language":"pt","tag":"Subcontas","count":9},{"language":"zh","tag":"子账户","count":9},{"language":"en","tag":"Exports","count":8},{"language":"en","tag":"Research","count":8},{"language":"en","tag":"SERP","count":8},{"language":"de","tag":"Exporte","count":8},{"language":"de","tag":"Recherche","count":8},{"language":"de","tag":"SERP","count":8},{"language":"es","tag":"Exportaciones","count":8},{"language":"es","tag":"Investigación","count":8},{"language":"es","tag":"SERP","count":8},{"language":"fr","tag":"Exports","count":8},{"language":"fr","tag":"Analyses","count":8},{"language":"fr","tag":"SERP","count":8},{"language":"ja","tag":"エクスポート","count":8},{"language":"ja","tag":"リサーチ","count":8},{"language":"ja","tag":"SERP","count":8},{"language":"ko","tag":"내보내기","count":8},{"language":"ko","tag":"리서치","count":8},{"language":"ko","tag":"SERP","count":8},{"language":"pt","tag":"Exportações","count":8},{"language":"pt","tag":"Pesquisa","count":8},{"language":"pt","tag":"SERP","count":8},{"language":"zh","tag":"导出","count":8},{"language":"zh","tag":"研究","count":8},{"language":"zh","tag":"SERP","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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","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":"ko/api-reference/get-task","slug":"/ko/api-reference/get-task","pageMetadata":{"title":"태스크 조회","description":"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.","openapi":"GET /v1/async/task/{id}","href":"/ko/api-reference/get-task"},"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: \"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\"\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":"태스크 조회","description":"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.","openapi":"GET /v1/async/task/{id}","href":"/ko/api-reference/get-task"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/querying-ai/50db3c2a8c6df10f/pretendard.js","/_mintlify/custom/querying-ai/076e6719f53a8bea/sidebar-scroll.js"],"openApiReferenceData":{"operation":{"summary":"Get a task","description":"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.","operationId":"getTask","tags":["Tasks"],"parameters":["87648c62-3fc2-4a1b-889d-aadc8677b421"],"responses":{"200":"c314e894-476e-4830-8a2c-78e97a6d18af","401":"344e4b85-f890-4e42-86d6-f9166d0dda39","404":"637977ea-b96d-4a77-ae52-18b74c12d995"},"method":"get","type":"path","servers":["03c555ab-4c28-4095-a5ca-17c281dd6cf9"],"security":["4887dbeb-be34-4005-a589-3b886b7d7629"],"path":"/v1/async/task/{id}","baseUrlOptions":["https://api.querying.ai"],"title":"Get a task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"87648c62-3fc2-4a1b-889d-aadc8677b421":{"name":"id","in":"path","required":true,"description":"The task id returned at submit time.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The task id returned at submit time.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"c314e894-476e-4830-8a2c-78e97a6d18af":{"description":"The task, plus `response` or `error` once terminal.","content":{"application/json":{"schema":{"type":"object","required":["success","task","credits"],"properties":{"success":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"task":{"type":"object","required":["id","taskType","status","priority","createdAt","latencyMs"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"task.id","typeLabel":"string\u003cuuid>"},"taskType":{"oneOf":[{"type":"string","description":"Task types returned by task polling, submissions, batch results and webhooks, including tasks created by dedicated endpoints. This is not a submission engine list.","enum":["CHATGPT","PERPLEXITY","GEMINI","AIMODE","GOOGLE_AIMODE","GOOGLE","GOOGLE_AIO","GOOGLE_SERP","GOOGLE_PLACES","GOOGLE_NEWS","NAVER_AI_BRIEF","NAVER_AI_TAB","NAVER_AI_MODE","NAVER","NAVER_SERP","COMMERCE_SERP","COMMERCE_PRODUCT","BING_SEARCH","BRAVE_SEARCH","BING","COPILOT","BING_COPILOT","MICROSOFT_COPILOT","BING_AIMODE","BING_COPILOT_SEARCH","COPILOT_SEARCH","META_AI","QWEN","DOUBAO","BAIDU_WENXIN","BAIDU_AI_SEARCH","CITATION_ANALYSIS","GEO_AUDIT","SOURCE_INFLUENCE","CITATION_ATTRIBUTION","PROMPT_RESEARCH","GEO_SCORE","SEARCH","WEB_SEARCH","WEB_SCRAPE"],"isRequired":true,"uniqueKey":"task.taskType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Task types returned by task polling, submissions, batch results and webhooks, including tasks created by dedicated endpoints. This is not a submission engine list.","enum":["AI_RENDERING"],"isRequired":true,"uniqueKey":"task.taskType.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"task.taskType","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"`PROCESSING` means a worker holds the task. `COMPLETED` and `FAILED` are terminal. For NAVER_AI_TAB with response.upstreamError, `COMPLETED` means collection finished; the answer may still be incomplete.","enum":["QUEUED","PROCESSING","COMPLETED","FAILED"],"isRequired":true,"uniqueKey":"task.status","typeLabel":"enum\u003cstring>"},"priority":{"type":"integer","isRequired":true,"uniqueKey":"task.priority","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"task.createdAt","typeLabel":"string\u003cdate-time>"},"latencyMs":{"oneOf":[{"type":"integer","description":"Milliseconds from the worker's first pickup to the final outcome, excluding the queue wait. `null` until the task settles. Returned by polling, the webhook and the submit response alike.","isRequired":true,"uniqueKey":"task.latencyMs.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Milliseconds from the worker's first pickup to the final outcome, excluding the queue wait. `null` until the task settles. Returned by polling, the webhook and the submit response alike.","isRequired":true,"uniqueKey":"task.latencyMs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.latencyMs","typeLabel":"integer | null"},"idempotencyKey":{"type":"string","description":"Echoed back verbatim. **Omitted**, not null, when the caller supplied none.","uniqueKey":"task.idempotencyKey","typeLabel":"string"}},"isRequired":true,"uniqueKey":"task","typeLabel":"object"},"credits":{"type":"object","description":"Credits, with up to two decimals (for example `1.25`). The submit response always shows `0`: nothing is charged yet, and the task's price is held from your balance when it starts. Polling shows `0` until the task is terminal, then the settled charge: the task's price for COMPLETED, `0` for FAILED. A task webhook reports the same charge in `creditsCharged`; on a FAILED task it reports the task's price in `creditsToCharge` and `0` in `creditsCharged`. CITATION_ANALYSIS, GOOGLE_PLACES and GOOGLE_NEWS are charged by usage, up to the hold placed when the task starts.","properties":{"creditsToCharge":{"type":"number","uniqueKey":"credits.creditsToCharge","typeLabel":"number"},"creditsCharged":{"oneOf":[{"type":"number","uniqueKey":"credits.creditsCharged.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"credits.creditsCharged.oneOf.1","typeLabel":"null"}],"uniqueKey":"credits.creditsCharged","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"credits","typeLabel":"object"},"response":{"type":"object","description":"The engine-specific result. Absent until the task is terminal. See the Engines guide for per-engine shapes. NAVER_AI_TAB preserves the original text, markdown, sources and cards when Naver returns HTTP success, a valid stream ending in done, and nonempty answer text with unknown_error. It includes upstreamError and returns immediately without retrying or rephrasing, even with retryQuery. COMPLETED means collection finished; the answer may still be incomplete. Empty, cut-off or malformed streams still fail. Policy refusals complete with a policy_declined notice. rawContent is returned only with include.rawResponse. With `include.citationAnalysis`, answer results also carry `citationAnalysis` (see Include). CITATION_ANALYSIS returns CitationAnalysisResult; see the Citation Analysis guide. PROMPT_RESEARCH returns PromptResearchResult; see the Prompt Research guide. GEO_SCORE returns GeoScoreResult; see the GEO Score guide. Answer engines with `include.analysis` add `analysis` (AnswerAnalysis).","properties":{"upstreamError":{"type":"object","description":"Optional NAVER_AI_TAB generation error accompanying preserved answer text. Collection finished, but the answer may be incomplete.","required":["type"],"additionalProperties":false,"properties":{"type":{"type":"string","const":"unknown_error","isRequired":true,"uniqueKey":"response.upstreamError.type","typeLabel":"string"},"message":{"type":"string","description":"Naver's exact notice text, without translation or rewording. Omitted when Naver provides no notice text.","uniqueKey":"response.upstreamError.message","typeLabel":"string"}},"uniqueKey":"response.upstreamError","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"response","typeLabel":"object"},"error":{"type":"string","description":"Present when `task.status` is `FAILED`. A plain string, not the `{code, message, timestamp}` object used by request-level errors.","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"queued":{"title":"queued","summary":"Still queued, no response yet","value":{"success":true,"task":{"id":"8f2c1e40-0000-0000-0000-000000000000","taskType":"GEMINI","status":"QUEUED","priority":1,"createdAt":"2026-07-09T04:12:00.000Z","latencyMs":null},"credits":{"creditsToCharge":0,"creditsCharged":0}}},"completed":{"title":"completed","summary":"Completed","value":{"success":true,"task":{"id":"8f2c1e40-0000-0000-0000-000000000000","taskType":"GEMINI","status":"COMPLETED","priority":1,"createdAt":"2026-07-09T04:12:00.000Z","latencyMs":8412},"credits":{"creditsToCharge":1.25,"creditsCharged":1.25},"response":{"text":"The best wireless earbuds in 2026 are ...","sources":[{"position":1,"url":"https://example.com/review","label":"Best earbuds, reviewed"}]}}},"naverUpstreamError":{"title":"naverUpstreamError","summary":"Naver answer preserved with an upstream error","description":"Collection finished; the answer may be incomplete.","value":{"success":true,"task":{"id":"8f2c1e40-0000-0000-0000-000000000000","taskType":"NAVER_AI_TAB","status":"COMPLETED","priority":1,"createdAt":"2026-07-09T04:12:00.000Z","latencyMs":8412},"credits":{"creditsToCharge":1.25,"creditsCharged":1.25},"response":{"text":"2","markdown":"2","sources":[],"upstreamError":{"type":"unknown_error"}}}},"failed":{"title":"failed","summary":"Failed: `error` is a string here, not an object","value":{"success":true,"task":{"id":"8f2c1e40-0000-0000-0000-000000000000","taskType":"GEMINI","status":"FAILED","priority":1,"createdAt":"2026-07-09T04:12:00.000Z","latencyMs":8412},"credits":{"creditsToCharge":0,"creditsCharged":0},"error":"ENGINE_TIMEOUT: The engine did not answer before the task deadline."}}},"exampleType":"examples"}},"exampleType":"examples"},"344e4b85-f890-4e42-86d6-f9166d0dda39":{"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"},"637977ea-b96d-4a77-ae52-18b74c12d995":{"description":"Unknown task id, another account's task, or a terminal task past the 24-hour polling window. The cases are indistinguishable.","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":"RESOURCE_NOT_FOUND","message":"Task not found","details":{"id":"8f2c1e40-0000-0000-0000-000000000000"},"timestamp":"2026-07-09T04:12:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"RESOURCE_NOT_FOUND","message":"Task not found","details":{"id":"8f2c1e40-0000-0000-0000-000000000000"},"timestamp":"2026-07-09T04:12:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4887dbeb-be34-4005-a589-3b886b7d7629":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key, sent as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"03c555ab-4c28-4095-a5ca-17c281dd6cf9":{"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":"태스크 조회 - querying.ai","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-task","matchLevel":1},"ko":{"href":"/ko/api-reference/get-task","matchLevel":0},"ja":{"href":"/ja/api-reference/get-task","matchLevel":1},"zh":{"href":"/zh/api-reference/get-task","matchLevel":1},"es":{"href":"/es/api-reference/get-task","matchLevel":1},"fr":{"href":"/fr/api-reference/get-task","matchLevel":1},"de":{"href":"/de/api-reference/get-task","matchLevel":1},"pt":{"href":"/pt/api-reference/get-task","matchLevel":1}}},"lastModified":"2026-09-28T12:24:18.828Z","originalFileLocation":"ko/api-reference/get-task.mdx","locale":"ko"},"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=\"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\">\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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/querying-ai/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_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/2DfxV-wlBr1l-bh0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"태스크 조회 - querying.ai\">\u003cmeta data-mint-head property=\"og:description\" content=\"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"querying.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.querying.ai/ko/api-reference/get-task\">\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=%ED%83%9C%EC%8A%A4%ED%81%AC\u0026amp;title=%ED%83%9C%EC%8A%A4%ED%81%AC+%EC%A1%B0%ED%9A%8C\u0026amp;description=id%EB%A1%9C+%ED%83%9C%EC%8A%A4%ED%81%AC%EB%A5%BC+%ED%8F%B4%EB%A7%81%ED%95%A9%EB%8B%88%EB%8B%A4.+%EC%A2%85%EB%A3%8C+%EA%B2%B0%EA%B3%BC%EB%8A%94+%EC%99%84%EB%A3%8C+%ED%9B%84+24%EC%8B%9C%EA%B0%84+%EB%8F%99%EC%95%88+%EC%A1%B0%ED%9A%8C%ED%95%A0+%EC%88%98+%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.\u0026amp;theme=a594992072db4a12a05c91e2\u0026amp;signature=f914c3650facf5ebcdd89f169bd569954326eeff802fce65afbd2155281f972a\">\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=\"태스크 조회 - querying.ai\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://querying-ai.mintlify.site/_mintlify/api/og/v2?division=%ED%83%9C%EC%8A%A4%ED%81%AC\u0026amp;title=%ED%83%9C%EC%8A%A4%ED%81%AC+%EC%A1%B0%ED%9A%8C\u0026amp;description=id%EB%A1%9C+%ED%83%9C%EC%8A%A4%ED%81%AC%EB%A5%BC+%ED%8F%B4%EB%A7%81%ED%95%A9%EB%8B%88%EB%8B%A4.+%EC%A2%85%EB%A3%8C+%EA%B2%B0%EA%B3%BC%EB%8A%94+%EC%99%84%EB%A3%8C+%ED%9B%84+24%EC%8B%9C%EA%B0%84+%EB%8F%99%EC%95%88+%EC%A1%B0%ED%9A%8C%ED%95%A0+%EC%88%98+%EC%9E%88%EC%8A%B5%EB%8B%88%EB%8B%A4.\u0026amp;theme=a594992072db4a12a05c91e2\u0026amp;signature=f914c3650facf5ebcdd89f169bd569954326eeff802fce65afbd2155281f972a\">\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/2DfxV-wlBr1l-bh0/_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/ko/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/api-reference/get-task.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.querying.ai/ko/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.querying.ai/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.querying.ai/ja/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.querying.ai/zh/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.querying.ai/es/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.querying.ai/fr/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.querying.ai/de/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.querying.ai/pt/api-reference/get-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.querying.ai/api-reference/get-task\">\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/ko/api-reference/get-task#webpage\",\"url\":\"https://docs.querying.ai/ko/api-reference/get-task\",\"name\":\"태스크 조회\",\"description\":\"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\",\"dateModified\":\"2026-09-28T12:24:18.828Z\",\"isPartOf\":{\"@id\":\"https://docs.querying.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.querying.ai/ko/api-reference/get-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.querying.ai/ko/api-reference/get-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"태스크\",\"item\":\"https://docs.querying.ai/ko/api-reference/create-task\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"태스크 조회\",\"item\":\"https://docs.querying.ai/ko/api-reference/get-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.querying.ai/ko/api-reference/get-task#apireference\",\"headline\":\"태스크 조회\",\"name\":\"태스크 조회\",\"description\":\"id로 태스크를 폴링합니다. 종료 결과는 완료 후 24시간 동안 조회할 수 있습니다.\",\"url\":\"https://docs.querying.ai/ko/api-reference/get-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.querying.ai/ko/api-reference/get-task#webpage\"},\"dateModified\":\"2026-09-28T12:24:18.828Z\",\"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":"/ko/api-reference/get-task.md","siteName":"querying.ai","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/get-task"}]},{"language":"ko","tabs":[{"tab":"가이드","pages":[{"title":"가이드","href":"/ko/introduction"}]},{"tab":"API 레퍼런스","groups":[{"group":"태스크","pages":[{"title":"태스크 생성","openapi":"POST /v1/async/task","href":"/ko/api-reference/create-task"},{"title":"태스크 동기 실행","description":"단건 태스크를 제출하고 같은 요청에서 결과를 받습니다. 최대 290초까지 기다립니다.","openapi":"POST /v1/sync/task","href":"/ko/api-reference/sync-task"},{"title":"태스크 조회","openapi":"GET /v1/async/task/{id}","href":"/ko/api-reference/get-task"},{"title":"태스크 일괄 생성","description":"한 요청으로 최대 500개 태스크를 큐에 넣으며, 엔진을 자유롭게 섞을 수 있습니다.","openapi":"POST /v1/async/task/batch","href":"/ko/api-reference/create-task-batch"}]},{"group":"배치","pages":[{"title":"배치 생성","openapi":"POST /v1/batches","href":"/ko/api-reference/create-batch"},{"title":"배치 조회","openapi":"GET /v1/batches/{id}","href":"/ko/api-reference/get-batch"},{"title":"배치 항목 목록","openapi":"GET /v1/batches/{id}/items","href":"/ko/api-reference/list-batch-items"}]},{"group":"위치 그리드","pages":[{"title":"좌표 격자 생성","openapi":"POST /v1/async/task/grid","href":"/ko/api-reference/create-task-grid"},{"title":"좌표 격자 조회","openapi":"GET /v1/async/task/grid/{id}","href":"/ko/api-reference/get-task-grid"}]},{"group":"Search","pages":[{"title":"Search","openapi":"POST /v1/search","href":"/ko/api-reference/search"}]},{"group":"리서치","pages":[{"title":"Prompt Research","openapi":"POST /v1/prompt-research","href":"/ko/api-reference/prompt-research"},{"title":"GEO Score","openapi":"POST /v1/geo-score","href":"/ko/api-reference/geo-score"},{"title":"Place Lookup 생성","openapi":"POST /v1/place-lookup","href":"/ko/api-reference/place-lookup"},{"title":"Place Lookup 결과 조회","openapi":"GET /v1/place-lookup/{id}","href":"/ko/api-reference/get-place-lookup"}]},{"group":"AI Rendering","pages":[{"title":"페이지 진단","openapi":"POST /v1/ai-rendering/checks","href":"/ko/api-reference/ai-rendering/create-check"},{"title":"진단 조회","openapi":"GET /v1/ai-rendering/checks/{id}","href":"/ko/api-reference/ai-rendering/get-check"},{"title":"사이트 목록","openapi":"GET /v1/ai-rendering/sites","href":"/ko/api-reference/ai-rendering/list-sites"},{"title":"사이트 연결","openapi":"POST /v1/ai-rendering/sites","href":"/ko/api-reference/ai-rendering/create-site"},{"title":"사이트 조회","openapi":"GET /v1/ai-rendering/sites/{id}","href":"/ko/api-reference/ai-rendering/get-site"},{"title":"사이트 수정","openapi":"PATCH /v1/ai-rendering/sites/{id}","href":"/ko/api-reference/ai-rendering/update-site"},{"title":"사이트 삭제","openapi":"DELETE /v1/ai-rendering/sites/{id}","href":"/ko/api-reference/ai-rendering/delete-site"},{"title":"새 사이트 키","openapi":"POST /v1/ai-rendering/sites/{id}/key","href":"/ko/api-reference/ai-rendering/rotate-key"},{"title":"페이지 게시","openapi":"POST /v1/ai-rendering/sites/{id}/pages","href":"/ko/api-reference/ai-rendering/publish-page"},{"title":"페이지 대량 게시","openapi":"POST /v1/ai-rendering/sites/{id}/pages/batch","href":"/ko/api-reference/ai-rendering/publish-pages"},{"title":"사이트 페이지 목록","openapi":"GET /v1/ai-rendering/sites/{id}/pages","href":"/ko/api-reference/ai-rendering/list-pages"},{"title":"사이트 활동 조회","openapi":"GET /v1/ai-rendering/sites/{id}/activity","href":"/ko/api-reference/ai-rendering/get-activity"},{"title":"사용량 조회","openapi":"GET /v1/ai-rendering/usage","href":"/ko/api-reference/ai-rendering/get-usage"},{"title":"사이트 진단","openapi":"POST /v1/ai-rendering/site-checks","href":"/ko/api-reference/ai-rendering/check-site"},{"title":"사이트 연동 확인","openapi":"POST /v1/ai-rendering/sites/{id}/verifications","href":"/ko/api-reference/ai-rendering/create-verification"},{"title":"연동 확인 조회","openapi":"GET /v1/ai-rendering/sites/{id}/verifications/{verificationId}","href":"/ko/api-reference/ai-rendering/get-verification"},{"title":"연동 확인 목록","openapi":"GET /v1/ai-rendering/sites/{id}/verifications","href":"/ko/api-reference/ai-rendering/list-verifications"},{"title":"페이지 내리기","openapi":"DELETE /v1/ai-rendering/sites/{id}/pages/{pageId}","href":"/ko/api-reference/ai-rendering/delete-page"},{"title":"사이트 사본 목록","openapi":"GET /v1/ai-rendering/copies","href":"/ko/api-reference/ai-rendering/list-copies"}]},{"group":"모니터","pages":[{"title":"모니터 목록","openapi":"GET /v1/monitors","href":"/ko/api-reference/monitors/list-monitors"},{"title":"모니터 생성","openapi":"POST /v1/monitors","href":"/ko/api-reference/monitors/create-monitor"},{"title":"모니터 조회","openapi":"GET /v1/monitors/{id}","href":"/ko/api-reference/monitors/get-monitor"},{"title":"모니터 수정","openapi":"PATCH /v1/monitors/{id}","href":"/ko/api-reference/monitors/update-monitor"},{"title":"모니터 삭제","openapi":"DELETE /v1/monitors/{id}","href":"/ko/api-reference/monitors/delete-monitor"},{"title":"모니터 즉시 실행","openapi":"POST /v1/monitors/{id}/run","href":"/ko/api-reference/monitors/run-monitor"},{"title":"모니터 분석 조회","openapi":"GET /v1/monitors/{id}/analytics","href":"/ko/api-reference/monitors/get-analytics"},{"title":"인용 출처 목록","openapi":"GET /v1/monitors/{id}/sources","href":"/ko/api-reference/monitors/list-sources"},{"title":"기간별 인용 조회","openapi":"GET /v1/monitors/{id}/citations","href":"/ko/api-reference/monitors/get-citations"},{"title":"채점된 답변 조회","openapi":"GET /v1/monitors/{id}/answers/{taskId}","href":"/ko/api-reference/monitors/get-answer"},{"title":"프롬프트 조회","openapi":"GET /v1/monitors/{id}/prompt","href":"/ko/api-reference/monitors/get-prompt"},{"title":"채점된 답변 내보내기","openapi":"GET /v1/monitors/{id}/results","href":"/ko/api-reference/monitors/export-results"},{"title":"위치별 모니터 답변 조회","openapi":"GET /v1/monitors/{id}/grid","href":"/ko/api-reference/monitors/get-grid"},{"title":"변경 이벤트 목록","openapi":"GET /v1/monitors/{id}/events","href":"/ko/api-reference/monitors/list-events"},{"title":"변경 이벤트 재전송","openapi":"POST /v1/monitors/{id}/events/{eventId}/redeliver","href":"/ko/api-reference/monitors/redeliver-event"},{"title":"알림 이력 조회","openapi":"GET /v1/monitors/{id}/alerts","href":"/ko/api-reference/monitors/get-alerts"},{"title":"테스트 알림 보내기","openapi":"POST /v1/monitors/{id}/alerts/test","href":"/ko/api-reference/monitors/test-alert"},{"title":"모니터 기능 조회","openapi":"GET /v1/monitors/capabilities","href":"/ko/api-reference/monitors/get-capabilities"},{"title":"프롬프트 제안","openapi":"POST /v1/monitors/suggest","href":"/ko/api-reference/monitors/suggest-prompts"},{"title":"모니터용 프롬프트 리서치","openapi":"POST /v1/monitors/research","href":"/ko/api-reference/monitors/research-prompts"},{"title":"리포트 공유 조회","openapi":"GET /v1/monitors/{id}/share","href":"/ko/api-reference/monitors/get-share"},{"title":"리포트 공유","openapi":"PUT /v1/monitors/{id}/share","href":"/ko/api-reference/monitors/update-share"}]},{"group":"내보내기","pages":[{"title":"내보내기 목록","openapi":"GET /v1/exports","href":"/ko/api-reference/exports/list-exports"},{"title":"내보내기 생성","openapi":"POST /v1/exports","href":"/ko/api-reference/exports/create-export"},{"title":"내보내기 ID 조회","openapi":"GET /v1/exports/identity","href":"/ko/api-reference/exports/get-identity"},{"title":"내보내기 조회","openapi":"GET /v1/exports/{id}","href":"/ko/api-reference/exports/get-export"},{"title":"내보내기 일시 중지 또는 재개","openapi":"PATCH /v1/exports/{id}","href":"/ko/api-reference/exports/update-export"},{"title":"내보내기 삭제","openapi":"DELETE /v1/exports/{id}","href":"/ko/api-reference/exports/delete-export"},{"title":"전송 이력 목록","openapi":"GET /v1/exports/{id}/runs","href":"/ko/api-reference/exports/list-runs"},{"title":"전송 구간 재시도","openapi":"POST /v1/exports/{id}/runs/{runId}/retry","href":"/ko/api-reference/exports/retry-run"}]},{"group":"하위 계정","pages":[{"title":"하위 계정 목록","openapi":"GET /v1/sub-accounts","href":"/ko/api-reference/sub-accounts/list-sub-accounts"},{"title":"하위 계정 생성","openapi":"POST /v1/sub-accounts","href":"/ko/api-reference/sub-accounts/create-sub-account"},{"title":"하위 계정 조회","openapi":"GET /v1/sub-accounts/{id}","href":"/ko/api-reference/sub-accounts/get-sub-account"},{"title":"하위 계정 수정 또는 정지","openapi":"PATCH /v1/sub-accounts/{id}","href":"/ko/api-reference/sub-accounts/update-sub-account"},{"title":"하위 계정 키 목록","openapi":"GET /v1/sub-accounts/{id}/keys","href":"/ko/api-reference/sub-accounts/list-keys"},{"title":"하위 계정 키 발급","openapi":"POST /v1/sub-accounts/{id}/keys","href":"/ko/api-reference/sub-accounts/issue-key"},{"title":"하위 계정 키 폐기","openapi":"DELETE /v1/sub-accounts/{id}/keys/{keyId}","href":"/ko/api-reference/sub-accounts/revoke-key"},{"title":"하위 계정 사용량 조회","openapi":"GET /v1/sub-accounts/{id}/usage","href":"/ko/api-reference/sub-accounts/get-usage"},{"title":"전체 하위 계정 사용량 목록","openapi":"GET /v1/sub-accounts/usage","href":"/ko/api-reference/sub-accounts/list-usage"}]},{"group":"운영","pages":[{"title":"엔진 기능 목록","openapi":"GET /v1/capabilities","href":"/ko/api-reference/capabilities"},{"title":"지원 국가 목록","openapi":"GET /v1/countries","href":"/ko/api-reference/countries"},{"title":"지원 주 목록","openapi":"GET /v1/states","href":"/ko/api-reference/states"},{"title":"크레딧 잔액","openapi":"GET /v1/credits","href":"/ko/api-reference/credits"},{"title":"크레딧 사용량","openapi":"GET /v1/usage","href":"/ko/api-reference/usage"},{"title":"대기열 상태","openapi":"GET /v1/async/status","href":"/ko/api-reference/queue-status"},{"title":"Google 리다이렉트 해석","openapi":"POST /v1/google/goto","href":"/ko/api-reference/google-goto"},{"title":"대기열 비우기","openapi":"DELETE /v1/async/queue","href":"/ko/api-reference/clear-queue"},{"title":"Liveness 확인","openapi":"GET /health","href":"/ko/api-reference/health"},{"title":"Readiness 확인","openapi":"GET /ready","href":"/ko/api-reference/ready"},{"title":"계정 태스크 수","sidebarTitle":"통계","openapi":"GET /stats","href":"/ko/api-reference/stats"},{"title":"ChatGPT 서빙 모드","sidebarTitle":"용량","openapi":"GET /capacity","href":"/ko/api-reference/capacity"}]}]}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/api-reference/get-task"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/get-task"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/get-task"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/get-task"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/get-task"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/api-reference/get-task"}]}]},"basePath":"","title":"태스크 조회 - querying.ai","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","Page-Cr9IwkK7.js","CodeSnippet-eoRjC4Le.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","getApiPlaygroundDisplay-CZyAPlR2.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}