As in SearchRequest, a natural-language description of the underlying question or goal driving the request. Used together with search_queries to focus excerpts on the most relevant content.
Session identifier to track calls across separate search and extract calls, to be used as part of a larger task. Specifying it may give better contextual results for subsequent API calls.
Advanced configuration for fetch policy, excerpt settings, and full content settings. May impact result quality and latency unless used carefully. When omitted, excerpts are enabled and full content is disabled by default.
Session identifier. Echoed back from the request if provided, otherwise generated by the server. Should be passed to future search and extract calls made by the agent as part of the same larger task.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Parallel","description":"Parallel's web APIs (Search, Extract, Task/Deep Research, Responses, FindAll, and Monitor) give AI agents and developers high-quality, low-latency access to the web for research, content extraction, entity discovery, and continuous monitoring. For Search and Extract, use /v1/search and /v1/extract for all new integrations and agent tool calls; use /v1beta/search and /v1beta/extract only when maintaining an existing integration that already uses them. The request bodies changed too: on /v1/extract, full_content, fetch_policy and excerpt_settings go inside advanced_settings, and sending the v1beta top-level excerpts, full_content and fetch_policy to /v1/extract returns a 422. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.","colors":{"primary":"#FB631B","light":"#fcfcfa","dark":"#1d1b16"},"logo":{"light":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_light.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=955d1146a212bea2279ca4ee6916b8ae","dark":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_dark.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=0039edb690a1759b9276a8691e19bf84"},"favicon":"https://mintcdn.com/parallel-6fabab31-mtje7p526we/dsxqJ8pzmudWCd39/favicon.svg?fit=max\u0026auto=format\u0026n=dsxqJ8pzmudWCd39\u0026q=85\u0026s=41982ed7e9fa034a1be0b73fb7294e48","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["python","typescript","java","curl"]}},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"API Playground","href":"https://platform.parallel.ai"}},"footer":{"socials":{"x":"https://x.com/p0","github":"https://github.com/parallel-web/parallel-cookbook","linkedin":"https://www.linkedin.com/company/parallel-web/about"},"links":[{"header":"Privacy","items":[{"label":"Cookie preferences","href":"#cookie-preferences"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Get API Key","icon":"key","href":"https://platform.parallel.ai"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.parallel.ai/public-openapi.json"},{"anchor":"Python SDK","icon":"python","href":"https://pypi.org/project/parallel-web/"},{"anchor":"TypeScript SDK","icon":"js","href":"https://www.npmjs.com/package/parallel-web"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"parallel-6fabab31-mtje7p526we","hasAudioNarration":false,"actualSubdomain":"parallel-6fabab31-mtje7p526we","customDomains":["docs.parallel.ai"],"gitSource":{"type":"github","owner":"shapleyai","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae130eca6efe86c91ff4a2d","collectionId":"248dd0ad-998a-4987-ae6f-5817c0384276","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae130eca6efe86c91ff4a2d"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae130eca6efe86c91ff4a2d","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Documentation","count":120},{"language":"default","tag":"Web Agents","count":45},{"language":"default","tag":"API Reference","count":38},{"language":"default","tag":"Features","count":23},{"language":"default","tag":"FindAll","count":22},{"language":"default","tag":"Web Tools","count":18},{"language":"default","tag":"Developer Tools","count":17},{"language":"default","tag":"Task","count":17},{"language":"default","tag":"Additional Resources","count":15},{"language":"default","tag":"Platform Integrations","count":14}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@parallel.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:'Gerstner Programm';src:url(https://assets.p0web.com/Gerstner-ProgrammRegular.woff2) format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'Gerstner Programm';src:url(https://assets.p0web.com/Gerstner-ProgrammMedium.woff2) format('woff2');font-weight:500;font-style:normal;font-display:swap}body,html{font-family:'Gerstner Programm',-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Oxygen,Ubuntu,Cantarell,sans-serif}@font-face{font-family:'FT System Mono';src:url(https://assets.p0web.com/FTSystemMono-Regular.woff2) format('woff2');font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:'FT System Mono';src:url(https://assets.p0web.com/FTSystemMono-Medium.woff2) format('woff2');font-weight:500;font-style:normal;font-display:swap}.code,[class*=language-],code,kbd,pre,samp,tt{font-family:'FT System Mono',monospace!important}h1,h2,h3,h4,h5,h6{font-weight:500!important;background:0 0!important;background-color:transparent!important;background-image:none!important}h1 mark,h2 mark,h3 mark,h4 mark,h5 mark,h6 mark{background:0 0!important;background-color:transparent!important;color:inherit!important}.font-normal h1,.font-normal h2,.font-normal h3{font-weight:400!important}.flex.flex-col.not-prose.relative.overflow-hidden,.mint-card,.not-prose,.rounded-2xl,.rounded-lg,.rounded-xl,[class*=Card],[class*=codeblock],[id*=code-group],[role=tabpanel],code,pre{border-radius:.375rem!important}[role=tab][aria-selected=true],[role=tab][data-headlessui-state=selected]{color:#fb631b!important;border-color:#fb631b!important}[role=tab][aria-selected=true] .absolute,[role=tab][data-headlessui-state=selected] .absolute{border-color:#fb631b!important}.dark .bg-codeblock,.dark .codeblock-dark,.dark .not-prose,.dark [class*=codeblock],.dark pre{background-color:#1d1b16!important}.bg-white\\/60,.not-prose,[class*=codeblock]{background-color:#fcfcfa!important}#pagination{display:none}.dark{--bg-color:#1d1b16}.dark .example-panel,.dark [class*=example-panel]{background-color:transparent!important}.dark .example-button.text-white{background-color:#fb631b!important}.dark .example-button,.dark .mint-card,.dark .mint-card:hover,.dark [class*=Card],.dark [class*=Card]:hover,.dark a[href]:hover>div,.dark a[href]>div,.dark a[href]>div:hover{background-color:transparent!important;background-image:none!important}.dark .rounded-md.border{background-color:transparent!important}.card,.card-title,.mint-card,.mint-card>div,[class*=Card],[class*=Card] h1,[class*=Card] h2,[class*=Card] h3,[class*=Card] h4,[class*=Card]>div,[data-card-title],[data-card],[role=group]>a>div{background:0 0!important;background-color:transparent!important;background-image:none!important}.mint-card [class*=title],[class*=Card] [class*=title]{background:0 0!important;background-color:transparent!important}.mint-card h3,.mint-card h4,[class*=Card] h3,[class*=Card] h4{font-size:1.125rem!important;font-weight:600!important;margin-bottom:.5rem!important}:not(pre):not(code):not([class*=language-]):not(.token){text-decoration-color:inherit!important}::selection:not(pre ::selection):not(code ::selection),mark:not(pre mark):not(code mark){background:0 0!important;background-color:transparent!important}:not(pre):not(code):not([class*=language-]):not(.token)::after,:not(pre):not(code):not([class*=language-]):not(.token)::before{background:inherit!important}a[href] h1,a[href] h2,a[href] h3,a[href] h4{text-decoration:none!important;background:0 0!important;background-color:transparent!important}[data-tabs] a,[data-tabs] button,header [role=navigation] a,header [role=navigation] button,header nav button,nav[data-orientation=horizontal] a,nav[data-orientation=horizontal] button{font-size:1.25rem!important}.prose ul:not(nav ul):not([role=navigation] ul),article ul:not(nav ul):not([role=navigation] ul){list-style-type:disc;list-style-position:outside;padding-left:1.5rem}.prose ol:not(nav ol):not([role=navigation] ol),article ol:not(nav ol):not([role=navigation] ol){list-style-type:decimal;list-style-position:outside;padding-left:1.5rem}.prose li:not(nav li):not([role=navigation] li),article li:not(nav li):not([role=navigation] li){display:list-item;margin-left:.5rem}[role=navigation] li,[role=navigation] ol,[role=navigation] ul,aside li,aside ol,aside ul,nav li,nav ol,nav ul{list-style-type:none!important}@media (min-width:1024px){#content-container{max-width:none!important}}.pricing-summary th:first-child{width:28%}.pricing-summary th:nth-child(2){width:48%}.example-panel pre{max-height:340px;overflow-y:auto;overflow-x:hidden;white-space:pre-wrap;word-break:break-word;scrollbar-gutter:stable}.example-panel .code-block>.print\\:hidden,html[data-current-path=\"/getting-started/overview\"] header#header{display:none!important}.example-panel pre::-webkit-scrollbar{width:8px}.example-panel pre::-webkit-scrollbar-thumb{background:rgba(0,0,0,.22);border-radius:4px;border:1px solid transparent;background-clip:padding-box}.dark .example-panel pre::-webkit-scrollbar-thumb{background:rgba(255,255,255,.22);background-clip:padding-box}.example-panel pre::-webkit-scrollbar-track{background:0 0}.example-tab-active{background-color:#eee!important}.dark .example-tab-active{background-color:rgba(255,255,255,.06)!important}.example-tab-list,.example-tab-list li{padding:0!important;margin:0!important;list-style:none!important}.example-tab-list li{display:block!important}.example-panel .code-block{margin-top:0!important;margin-bottom:0!important}.home-panel-link{font-size:.875rem;color:#4b5563;transition:color .15s}.dark .home-panel-link:hover,.home-panel-link:hover{color:#fb631b}.dark .home-panel-link{color:#9ca3af}.min-h-\\[260px\\]{min-height:260px}.bg-\\[\\#f6f6f6\\]{background-color:#f6f6f6}.bg-\\[\\#434343\\]{background-color:#434343}.hover\\:bg-\\[\\#2a2a2a\\]:hover{background-color:#2a2a2a}.border-\\[\\#e5e5e5\\]{border-color:#e5e5e5}.dark .dark\\:bg-\\[\\#1a1a1a\\]{background-color:#1a1a1a}.dark .dark\\:border-\\[\\#2a2a2a\\]{border-color:#2a2a2a}.dark .dark\\:bg-\\[\\#111\\]{background-color:#111}.bg-gray-50\\/60{background-color:rgb(249 250 251/.6)}.dark .dark\\:bg-white\\/\\[0\\.02\\]{background-color:rgb(255 255 255/.02)}.text-\\[12px\\]{font-size:12px}.text-\\[13px\\]{font-size:13px}@media (min-width:1024px){.lg\\:w-\\[262px\\]{width:262px}.lg\\:p-5{padding:1.25rem}.lg\\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}.lg\\:border-r{border-right-width:1px}.lg\\:border-b-0{border-bottom-width:0}.lg\\:border-gray-200{border-color:rgb(229 231 235)}.dark .lg\\:dark\\:border-\\[\\#2a2a2a\\]{border-color:#2a2a2a}}html[data-current-path=\"/getting-started/overview\"] [class*=max-w-6xl]>div:last-child{max-width:none!important}html[data-current-path=\"/getting-started/overview\"] h2.font-bold{font-weight:700!important}html[data-current-path=\"/getting-started/overview\"] .mdx-content,html[data-current-path=\"/getting-started/overview\"] .mdx-content h2{margin-top:0!important}html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt code{font-family:'FT System Mono',monospace!important;font-size:14px!important;font-weight:400!important;line-height:1.6!important}html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited{color:#0550ae!important;font-weight:400!important;text-decoration:none!important;border-bottom:0!important;box-shadow:none!important;background-image:none!important}.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,.dark html[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:active,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:focus,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:hover,html.dark[data-current-path=\"/getting-started/overview\"] .agent-onboarding-prompt a:visited{color:#79c0ff!important}.prose a:not([class*=card]):not([class*=button]){font-weight:400!important}.pw-consent{position:fixed;bottom:1rem;left:1rem;right:1rem;z-index:2147483000;max-height:calc(100dvh - 2rem);overflow-y:auto;border-radius:4px;background:rgba(34,34,34,.8);backdrop-filter:blur(6px);-webkit-backdrop-filter:blur(6px);padding:1rem;color:#fff;font-family:'Gerstner Programm',-apple-system,BlinkMacSystemFont,sans-serif;opacity:0;transform:translateY(12px);transition:opacity .4s cubic-bezier(.6,0,.2,1),transform .4s cubic-bezier(.6,0,.2,1)}.pw-consent[data-visible=true]{opacity:1;transform:translateY(0)}@media (min-width:768px){.pw-consent{bottom:1.5rem;left:1.5rem;right:auto;width:300px}}.pw-consent__stack{display:flex;flex-direction:column;gap:1rem}.pw-consent__body,.pw-consent__title{letter-spacing:.15px;margin:0;color:#fff}.pw-consent__title{font-size:16px;font-weight:500;line-height:24px}.pw-consent__body{font-size:13px;line-height:16px}.pw-consent__body a,.pw-consent__linkbtn{color:#fff;text-decoration:underline;background:0 0;border:0;padding:0;font:inherit;cursor:pointer}.pw-consent__panel{display:none;flex-direction:column;gap:.75rem;border-top:1px solid rgba(255,255,255,.15);padding-top:1rem}.pw-consent__panel[data-expanded=true]{display:flex}.pw-consent__row{display:flex;align-items:flex-start;justify-content:space-between;gap:.75rem}.pw-consent__label{font-size:13px;line-height:16px;letter-spacing:.15px;color:#fff}.pw-consent__always,.pw-consent__hint{margin-top:2px;color:rgba(255,255,255,.55)}.pw-consent__hint{display:block;font-size:12px;line-height:15px}.pw-consent__always{flex-shrink:0;font-family:'FT System Mono',monospace;font-size:11px;line-height:16px;text-transform:uppercase}.pw-consent__toggle{position:relative;flex-shrink:0;margin-top:2px;width:34px;height:20px;border:0;border-radius:9999px;background:rgba(255,255,255,.25);cursor:pointer;transition:background-color .2s cubic-bezier(.6,0,.2,1)}.pw-consent__btn:hover,.pw-consent__toggle[aria-checked=true]{background:#fff}.pw-consent__knob{position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:9999px;background:#fff;transition:left .2s cubic-bezier(.6,0,.2,1),background-color .2s}.pw-consent__toggle[aria-checked=true] .pw-consent__knob{left:16px;background:#222}.pw-consent__actions{display:flex;gap:1rem}.pw-consent__btn{flex:1 1 0;display:flex;align-items:center;justify-content:center;white-space:nowrap;border:0;border-radius:4px;background:#eee;color:#181818;padding:8px 16px;font-family:'FT System Mono',monospace;font-size:13px;line-height:16px;text-transform:uppercase;cursor:pointer;transition:background-color .2s}.pw-consent__btn--save{margin-top:4px;width:100%}@media (prefers-reduced-motion:reduce){.pw-consent,.pw-consent__btn,.pw-consent__knob,.pw-consent__toggle{transition:none}}"}],"page":{"pagePath":"api-reference/extract/extract","slug":"/api-reference/extract/extract","pageMetadata":{"title":"Extract","description":"Extracts relevant content from specific web URLs.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/extract","href":"/api-reference/extract/extract","autogeneratedByOpenApi":true},"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: \"Extracts relevant content from specific web URLs.\"\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":"system","config":{},"pageMetadata":{"title":"Extract","description":"Extracts relevant content from specific web URLs.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/extract","href":"/api-reference/extract/extract","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/parallel-6fabab31-mtje7p526we/8bc4b1f689ce2d52/consent.js","/_mintlify/custom/parallel-6fabab31-mtje7p526we/07c1eb0ddac88dfe/link-tracking.js"],"openApiReferenceData":{"operation":{"tags":["Extract"],"summary":"Extract","description":"Extracts relevant content from specific web URLs.","operationId":"extract_v1_extract_post","requestBody":"a7a0ca5e-b603-47ad-b595-2aee433489d3","responses":{"200":"4f98a066-8ce3-4bf0-bedb-0b1258e13b68","422":"2000adcf-40e1-4199-8075-7d0e02067433"},"x-code-samples":[{"lang":"Python","source":"from parallel import Parallel\n\nclient = Parallel()\n\nextract = client.extract(\n urls=[\"https://www.example.com\"],\n objective=\"Summarize the page\",\n)\nprint(extract.results)"},{"lang":"TypeScript","source":"import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst extract = await client.extract({\n urls: [\"https://www.example.com\"],\n objective: \"Summarize the page\",\n});\nconsole.log(extract.results);"},{"lang":"cURL","source":"curl --request POST \\\n --url https://api.parallel.ai/v1/extract \\\n --header 'Content-Type: application/json' \\\n --header 'x-api-key: \u003capi-key>' \\\n --data '{\n \"urls\": [\"https://www.example.com\"],\n \"objective\": \"Summarize the page\"\n}'"}],"method":"post","type":"path","servers":["620aa36c-e00c-4650-984e-634718d77b85"],"security":["5ddb5913-c181-4b76-9e4c-d5f8e8df8ad9"],"path":"/v1/extract","baseUrlOptions":["https://api.parallel.ai"],"title":"Extract","codeSamples":[{"lang":"Python","source":"from parallel import Parallel\n\nclient = Parallel()\n\nextract = client.extract(\n urls=[\"https://www.example.com\"],\n objective=\"Summarize the page\",\n)\nprint(extract.results)"},{"lang":"TypeScript","source":"import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst extract = await client.extract({\n urls: [\"https://www.example.com\"],\n objective: \"Summarize the page\",\n});\nconsole.log(extract.results);"},{"lang":"cURL","source":"curl --request POST \\\n --url https://api.parallel.ai/v1/extract \\\n --header 'Content-Type: application/json' \\\n --header 'x-api-key: \u003capi-key>' \\\n --data '{\n \"urls\": [\"https://www.example.com\"],\n \"objective\": \"Summarize the page\"\n}'"}],"requestExampleLanguages":["python","typescript","java","bash"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"urls":{"items":{"type":"string","uniqueKey":"urls.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Urls","description":"URLs to extract content from. Up to 20 URLs.","isRequired":true,"uniqueKey":"urls","typeLabel":"string[]"},"objective":{"oneOf":[{"type":"string","title":"Objective","description":"As in SearchRequest, a natural-language description of the underlying question or goal driving the request. Used together with search_queries to focus excerpts on the most relevant content.","uniqueKey":"objective.oneOf.0","typeLabel":"string"},{"type":"null","title":"Objective","description":"As in SearchRequest, a natural-language description of the underlying question or goal driving the request. Used together with search_queries to focus excerpts on the most relevant content.","uniqueKey":"objective.oneOf.1","typeLabel":"null"}],"uniqueKey":"objective","typeLabel":"string | null"},"search_queries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"search_queries.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Search Queries","description":"Optional keyword search queries, as in SearchRequest. Used together with objective to focus excerpts on the most relevant content.","uniqueKey":"search_queries.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Search Queries","description":"Optional keyword search queries, as in SearchRequest. Used together with objective to focus excerpts on the most relevant content.","uniqueKey":"search_queries.oneOf.1","typeLabel":"null"}],"uniqueKey":"search_queries","typeLabel":"string[] | null"},"max_chars_total":{"oneOf":[{"type":"integer","title":"Max Chars Total","description":"Upper bound on total characters across excerpts from all extracted results.","uniqueKey":"max_chars_total.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Chars Total","description":"Upper bound on total characters across excerpts from all extracted results.","uniqueKey":"max_chars_total.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_chars_total","typeLabel":"integer | null"},"session_id":{"oneOf":[{"type":"string","title":"Session Id","description":"Session identifier to track calls across separate search and extract calls, to be used as part of a larger task. Specifying it may give better contextual results for subsequent API calls.","maxLength":1000,"uniqueKey":"session_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Session Id","description":"Session identifier to track calls across separate search and extract calls, to be used as part of a larger task. Specifying it may give better contextual results for subsequent API calls.","uniqueKey":"session_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"session_id","typeLabel":"string | null"},"client_model":{"oneOf":[{"type":"string","title":"Client Model","description":"The model generating this request and consuming the results. Enables optimizations and tailors default settings for the model's capabilities.","example":"claude-opus-4-7","uniqueKey":"client_model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Model","description":"The model generating this request and consuming the results. Enables optimizations and tailors default settings for the model's capabilities.","example":"claude-opus-4-7","uniqueKey":"client_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"client_model","typeLabel":"string | null"},"advanced_settings":{"oneOf":[{"type":"object","title":"AdvancedExtractSettings","description":"Advanced configuration for fetch policy, excerpt settings, and full content settings. May impact result quality and latency unless used carefully. When omitted, excerpts are enabled and full content is disabled by default.","properties":{"fetch_policy":{"oneOf":[{"type":"object","title":"FetchPolicy","description":"Fetch policy: determines when to return cached content from the index (faster) vs fetching live content (fresher). Default is to use a dynamic policy based on the search objective and url. Note: enabling live fetch significantly increases extract latency because it requires fetching content from source websites.","properties":{"max_age_seconds":{"oneOf":[{"type":"integer","title":"Max Age Seconds","description":"Maximum age of cached content in seconds to trigger a live fetch. Minimum value 600 seconds (10 minutes).","example":86400,"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.max_age_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Age Seconds","description":"Maximum age of cached content in seconds to trigger a live fetch. Minimum value 600 seconds (10 minutes).","example":86400,"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.max_age_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.max_age_seconds","typeLabel":"integer | null"},"timeout_seconds":{"oneOf":[{"type":"number","title":"Timeout Seconds","description":"Timeout in seconds for fetching live content if unavailable in cache.","example":60,"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.timeout_seconds.oneOf.0","typeLabel":"number"},{"type":"null","title":"Timeout Seconds","description":"Timeout in seconds for fetching live content if unavailable in cache.","example":60,"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.timeout_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.timeout_seconds","typeLabel":"number | null"},"disable_cache_fallback":{"type":"boolean","title":"Disable Cache Fallback","description":"If false, fallback to cached content older than max-age if live fetch fails or times out. If true, returns an error instead.","default":false,"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0.disable_cache_fallback","typeLabel":"boolean"}},"uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.0","typeLabel":"FetchPolicy · object"},{"type":"null","description":"Fetch policy: determines when to return cached content from the index (faster) vs fetching live content (fresher). Default is to use a dynamic policy based on the search objective and url. Note: enabling live fetch significantly increases extract latency because it requires fetching content from source websites.","uniqueKey":"advanced_settings.oneOf.0.fetch_policy.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.fetch_policy","typeLabel":"FetchPolicy · object | null"},"excerpt_settings":{"oneOf":[{"type":"object","title":"V1ExcerptSettings","description":"Controls excerpt sizes. Provide excerpt settings for fine-grained control, or omit to use defaults.","properties":{"max_chars_per_result":{"oneOf":[{"type":"integer","title":"Max Chars Per Result","description":"Optional upper bound on the total number of characters to include per url. Excerpts may contain fewer characters than this limit to maximize relevance and token efficiency.","uniqueKey":"advanced_settings.oneOf.0.excerpt_settings.oneOf.0.max_chars_per_result.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Chars Per Result","description":"Optional upper bound on the total number of characters to include per url. Excerpts may contain fewer characters than this limit to maximize relevance and token efficiency.","uniqueKey":"advanced_settings.oneOf.0.excerpt_settings.oneOf.0.max_chars_per_result.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.excerpt_settings.oneOf.0.max_chars_per_result","typeLabel":"integer | null"}},"additionalProperties":false,"uniqueKey":"advanced_settings.oneOf.0.excerpt_settings.oneOf.0","typeLabel":"V1ExcerptSettings · object"},{"type":"null","description":"Controls excerpt sizes. Provide excerpt settings for fine-grained control, or omit to use defaults.","uniqueKey":"advanced_settings.oneOf.0.excerpt_settings.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.excerpt_settings","typeLabel":"V1ExcerptSettings · object | null"},"full_content":{"oneOf":[{"type":"object","title":"FullContentSettings","description":"Optional settings for returning full content.","default":false,"properties":{"max_chars_per_result":{"oneOf":[{"type":"integer","title":"Max Chars Per Result","description":"Optional limit on the number of characters to include in the full content for each url. Full content always starts at the beginning of the page and is truncated at the limit if necessary.","uniqueKey":"advanced_settings.oneOf.0.full_content.oneOf.0.max_chars_per_result.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Chars Per Result","description":"Optional limit on the number of characters to include in the full content for each url. Full content always starts at the beginning of the page and is truncated at the limit if necessary.","uniqueKey":"advanced_settings.oneOf.0.full_content.oneOf.0.max_chars_per_result.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings.oneOf.0.full_content.oneOf.0.max_chars_per_result","typeLabel":"integer | null"}},"uniqueKey":"advanced_settings.oneOf.0.full_content.oneOf.0","typeLabel":"FullContentSettings · object"},{"type":"boolean","title":"Full Content","description":"Controls full content extraction. Set to true to enable with defaults, false to disable, or provide FullContentSettings for fine-grained control.","default":false,"uniqueKey":"advanced_settings.oneOf.0.full_content.oneOf.1","typeLabel":"boolean"}],"uniqueKey":"advanced_settings.oneOf.0.full_content","typeLabel":"FullContentSettings · object | boolean"}},"additionalProperties":false,"uniqueKey":"advanced_settings.oneOf.0","typeLabel":"AdvancedExtractSettings · object"},{"type":"null","description":"Advanced configuration for fetch policy, excerpt settings, and full content settings. May impact result quality and latency unless used carefully. When omitted, excerpts are enabled and full content is disabled by default.","uniqueKey":"advanced_settings.oneOf.1","typeLabel":"null"}],"uniqueKey":"advanced_settings","typeLabel":"AdvancedExtractSettings · object | null"}},"additionalProperties":false,"type":"object","required":["urls"],"title":"V1ExtractRequest","description":"Extract request.","uniqueKey":"","typeLabel":"V1ExtractRequest · object"},"examples":{"Example":{"title":"Example","value":{"urls":["\u003cstring>"],"objective":"\u003cstring>","search_queries":["\u003cstring>"],"max_chars_total":123,"session_id":"\u003cstring>","client_model":"claude-opus-4-7","advanced_settings":{"fetch_policy":{"max_age_seconds":86400,"timeout_seconds":60,"disable_cache_fallback":false},"excerpt_settings":{"max_chars_per_result":123},"full_content":false}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"4f98a066-8ce3-4bf0-bedb-0b1258e13b68":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"extract_id":{"type":"string","title":"Extract Id","description":"Extract request ID, e.g. `extract_cad0a6d2dec046bd95ae900527d880e7`","isRequired":true,"uniqueKey":"extract_id","typeLabel":"string"},"results":{"items":{"properties":{"url":{"type":"string","title":"Url","description":"URL associated with the search result.","isRequired":true,"uniqueKey":"results.items.[INDEX].url","typeLabel":"string"},"excerpts":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].excerpts.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Excerpts","description":"Relevant excerpted content from the URL, formatted as markdown.","isRequired":true,"uniqueKey":"results.items.[INDEX].excerpts","typeLabel":"string[]"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Title of the webpage, if available.","uniqueKey":"results.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Title of the webpage, if available.","uniqueKey":"results.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].title","typeLabel":"string | null"},"publish_date":{"oneOf":[{"type":"string","title":"Publish Date","description":"Publish date of the webpage in YYYY-MM-DD format, if available.","uniqueKey":"results.items.[INDEX].publish_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Publish Date","description":"Publish date of the webpage in YYYY-MM-DD format, if available.","uniqueKey":"results.items.[INDEX].publish_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].publish_date","typeLabel":"string | null"},"full_content":{"oneOf":[{"type":"string","title":"Full Content","description":"Full content from the URL formatted as markdown, if requested.","uniqueKey":"results.items.[INDEX].full_content.oneOf.0","typeLabel":"string"},{"type":"null","title":"Full Content","description":"Full content from the URL formatted as markdown, if requested.","uniqueKey":"results.items.[INDEX].full_content.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].full_content","typeLabel":"string | null"}},"type":"object","required":["url","excerpts"],"title":"V1ExtractResult","description":"Extract result for a single URL.","uniqueKey":"results.items.[INDEX]","typeLabel":"V1ExtractResult · object"},"type":"array","title":"Results","description":"Successful extract results.","isRequired":true,"uniqueKey":"results","typeLabel":"V1ExtractResult · object[]"},"errors":{"items":{"properties":{"url":{"title":"Url","type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].url","typeLabel":"string"},"error_type":{"type":"string","title":"Error Type","description":"Error type.","isRequired":true,"uniqueKey":"errors.items.[INDEX].error_type","typeLabel":"string"},"http_status_code":{"oneOf":[{"type":"integer","title":"Http Status Code","description":"HTTP status code, if available.","isRequired":true,"uniqueKey":"errors.items.[INDEX].http_status_code.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Http Status Code","description":"HTTP status code, if available.","isRequired":true,"uniqueKey":"errors.items.[INDEX].http_status_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"errors.items.[INDEX].http_status_code","typeLabel":"integer | null"},"content":{"oneOf":[{"type":"string","title":"Content","description":"Content returned for http client or server errors, if any.","isRequired":true,"uniqueKey":"errors.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"null","title":"Content","description":"Content returned for http client or server errors, if any.","isRequired":true,"uniqueKey":"errors.items.[INDEX].content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"errors.items.[INDEX].content","typeLabel":"string | null"}},"type":"object","required":["url","error_type","http_status_code","content"],"title":"ExtractError","description":"Extract error details.","uniqueKey":"errors.items.[INDEX]","typeLabel":"ExtractError · object"},"type":"array","title":"Errors","description":"Extract errors: requested URLs not in the results.","isRequired":true,"uniqueKey":"errors","typeLabel":"ExtractError · object[]"},"session_id":{"type":"string","title":"Session Id","description":"Session identifier. Echoed back from the request if provided, otherwise generated by the server. Should be passed to future search and extract calls made by the agent as part of the same larger task.","examples":["session_8a911eb27c7a4afaa20d0d9dc98d07c0"],"isRequired":true,"uniqueKey":"session_id","typeLabel":"string"},"warnings":{"oneOf":[{"type":"array","items":{"properties":{"type":{"type":"string","enum":["spec_validation_warning","input_validation_warning","warning"],"title":"Type","description":"Type of warning. Note that adding new warning types is considered a backward-compatible change.","examples":["spec_validation_warning","input_validation_warning"],"isRequired":true,"uniqueKey":"warnings.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","title":"Message","description":"Human-readable message.","isRequired":true,"uniqueKey":"warnings.oneOf.0.items.[INDEX].message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","title":"Detail","description":"Optional detail supporting the warning.","additionalProperties":true,"uniqueKey":"warnings.oneOf.0.items.[INDEX].detail.oneOf.0","typeLabel":"Detail · object"},{"type":"null","title":"Detail","description":"Optional detail supporting the warning.","uniqueKey":"warnings.oneOf.0.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].detail","typeLabel":"Detail · object | null"}},"type":"object","required":["type","message"],"title":"Warning","description":"Human-readable message for a task.","uniqueKey":"warnings.oneOf.0.items.[INDEX]","typeLabel":"Warning · object"},"title":"Warnings","description":"Warnings for the extract request, if any.","uniqueKey":"warnings.oneOf.0","typeLabel":"Warning · object[]"},{"type":"null","title":"Warnings","description":"Warnings for the extract request, if any.","uniqueKey":"warnings.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings","typeLabel":"Warning · object[] | null"},"usage":{"oneOf":[{"type":"array","items":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the SKU.","examples":["sku_search","sku_extract_excerpts"],"isRequired":true,"uniqueKey":"usage.oneOf.0.items.[INDEX].name","typeLabel":"string"},"count":{"type":"integer","title":"Count","description":"Count of the SKU.","examples":[1],"isRequired":true,"uniqueKey":"usage.oneOf.0.items.[INDEX].count","typeLabel":"integer"}},"type":"object","required":["name","count"],"title":"UsageItem","description":"Usage item for a single operation.","uniqueKey":"usage.oneOf.0.items.[INDEX]","typeLabel":"UsageItem · object"},"title":"Usage","description":"Usage metrics for the extract request.","uniqueKey":"usage.oneOf.0","typeLabel":"UsageItem · object[]"},{"type":"null","title":"Usage","description":"Usage metrics for the extract request.","uniqueKey":"usage.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage","typeLabel":"UsageItem · object[] | null"}},"type":"object","required":["extract_id","results","errors","session_id"],"title":"V1ExtractResponse","description":"Extract response.","uniqueKey":"","typeLabel":"V1ExtractResponse · object"},"example":{"extract_id":"extract_8a911eb27c7a4afaa20d0d9dc98d07c0","results":[{"url":"https://www.example.com","title":"Example Title","excerpts":["Excerpted text ..."],"full_content":"Full content ..."}],"errors":[{"url":"https://www.example.com","error_type":"fetch_error","http_status_code":500,"content":"Error fetching content from https://www.example.com"}],"session_id":"session_8a911eb27c7a4afaa20d0d9dc98d07c0"},"examples":{"Example":{"title":"Example","value":{"extract_id":"extract_8a911eb27c7a4afaa20d0d9dc98d07c0","results":[{"url":"https://www.example.com","title":"Example Title","excerpts":["Excerpted text ..."],"full_content":"Full content ..."}],"errors":[{"url":"https://www.example.com","error_type":"fetch_error","http_status_code":500,"content":"Error fetching content from https://www.example.com"}],"session_id":"session_8a911eb27c7a4afaa20d0d9dc98d07c0"}}},"exampleType":"examples"}},"exampleType":"examples"},"2000adcf-40e1-4199-8075-7d0e02067433":{"description":"Request validation error","content":{"application/json":{"schema":{"properties":{"type":{"type":"string","const":"error","title":"Type","description":"Always 'error'.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"error":{"properties":{"ref_id":{"type":"string","title":"Reference ID","description":"Reference ID for the error.","isRequired":true,"uniqueKey":"error.ref_id","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Human-readable message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","title":"Detail","description":"Optional detail supporting the error.","additionalProperties":true,"uniqueKey":"error.detail.oneOf.0","typeLabel":"Detail · object"},{"type":"null","title":"Detail","description":"Optional detail supporting the error.","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"Detail · object | null"}},"type":"object","required":["ref_id","message"],"title":"Error","description":"Error.","isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"type":"object","required":["type","error"],"title":"ErrorResponse","description":"Response object used for non-200 status codes.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"type":"error","error":{"ref_id":"extract_8a911eb27c7a4afaa20d0d9dc98d07c0","message":"Request validation error"}},"examples":{"Example":{"title":"Example","value":{"type":"error","error":{"ref_id":"extract_8a911eb27c7a4afaa20d0d9dc98d07c0","message":"Request validation error"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"5ddb5913-c181-4b76-9e4c-d5f8e8df8ad9":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"620aa36c-e00c-4650-984e-634718d77b85":{"url":"https://api.parallel.ai","description":"Parallel API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"public-openapi.json"},"subdomain":"parallel-6fabab31-mtje7p526we","siteName":"Parallel","title":"Extract - Parallel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T15:01:35.054Z","originalFileLocation":"api-reference/extract/extract.mdx"},"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=\"light\"}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=\"Extracts relevant content from specific web URLs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Parallel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Extract - Parallel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Extracts relevant content from specific web URLs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Parallel\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.parallel.ai/api-reference/extract/extract\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://parallel-6fabab31-mtje7p526we.mintlify.app/_mintlify/api/og/v2?division=Extract\u0026amp;title=Extract\u0026amp;description=Extracts+relevant+content+from+specific+web+URLs.\u0026amp;theme=106af9efc399e2ef4c618350\u0026amp;signature=43ed93a263de74cf455945c4a16e2fb7ae1720ead1ac90c8fa99642e9d6591d3\">\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=\"Extract - Parallel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Extracts relevant content from specific web URLs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://parallel-6fabab31-mtje7p526we.mintlify.app/_mintlify/api/og/v2?division=Extract\u0026amp;title=Extract\u0026amp;description=Extracts+relevant+content+from+specific+web+URLs.\u0026amp;theme=106af9efc399e2ef4c618350\u0026amp;signature=43ed93a263de74cf455945c4a16e2fb7ae1720ead1ac90c8fa99642e9d6591d3\">\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/parallel-6fabab31-mtje7p526we/ZNRH8iM_vWv_wJYk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Parallel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FB631B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.parallel.ai/api-reference/extract/extract\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/extract/extract.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.parallel.ai/#organization\",\"name\":\"Parallel\",\"url\":\"https://docs.parallel.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/parallel-6fabab31-mtje7p526we/ODrEI5O3l6nnvEZD/logo/wordmark_light.svg?fit=max\u0026auto=format\u0026n=ODrEI5O3l6nnvEZD\u0026q=85\u0026s=955d1146a212bea2279ca4ee6916b8ae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.parallel.ai#website\",\"name\":\"Parallel\",\"url\":\"https://docs.parallel.ai\",\"publisher\":{\"@id\":\"https://docs.parallel.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.parallel.ai/api-reference/extract/extract#webpage\",\"url\":\"https://docs.parallel.ai/api-reference/extract/extract\",\"name\":\"Extract\",\"description\":\"Extracts relevant content from specific web URLs.\",\"dateModified\":\"2026-10-27T15:01:35.054Z\",\"isPartOf\":{\"@id\":\"https://docs.parallel.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.parallel.ai/api-reference/extract/extract#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.parallel.ai/api-reference/extract/extract#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Parallel\",\"item\":\"https://docs.parallel.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Extract\",\"item\":\"https://docs.parallel.ai/api-reference/extract/extract\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.parallel.ai/api-reference/extract/extract#apireference\",\"headline\":\"Extract\",\"name\":\"Extract\",\"description\":\"Extracts relevant content from specific web URLs.\",\"url\":\"https://docs.parallel.ai/api-reference/extract/extract\",\"mainEntityOfPage\":{\"@id\":\"https://docs.parallel.ai/api-reference/extract/extract#webpage\"},\"dateModified\":\"2026-10-27T15:01:35.054Z\",\"publisher\":{\"@id\":\"https://docs.parallel.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.parallel.ai#website\"}}]}\u003c/script>","siteName":"Parallel","nav":{"global":{"anchors":[{"anchor":"Get API Key","icon":"key","href":"https://platform.parallel.ai"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.parallel.ai/public-openapi.json"},{"anchor":"Python SDK","icon":"python","href":"https://pypi.org/project/parallel-web/"},{"anchor":"TypeScript SDK","icon":"js","href":"https://www.npmjs.com/package/parallel-web"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/getting-started/overview"}]},{"tab":"API Reference","icon":"magnifying-glass","groups":[{"group":"Search","pages":[{"title":"Search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/search","href":"/api-reference/search/search"}]},{"group":"Image Search","pages":[{"title":"Image search","description":"Searches the web for images.","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/images/search","href":"/api-reference/image-search/image-search"}]},{"group":"Extract","pages":[{"title":"Extract","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/extract","href":"/api-reference/extract/extract"}]},{"group":"Decisions","pages":[{"title":"Decisions","description":"Answer typed questions using current web evidence.","deprecated":null,"version":null,"sidebarTitle":"Decisions","openapi":"/public-openapi.json post /v1/decisions","href":"/api-reference/decisions/make-web-grounded-typed-decisions"}]},{"group":"Tasks","pages":[{"title":"Create Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/groups","href":"/api-reference/tasks/create-task-group"},{"title":"Retrieve Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}","href":"/api-reference/tasks/retrieve-task-group"},{"title":"Stream Task Group Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/events","href":"/api-reference/tasks/stream-task-group-events"},{"title":"Fetch Task Group Runs","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/runs","href":"/api-reference/tasks/fetch-task-group-runs"},{"title":"Add Runs to Task Group","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/groups/{taskgroup_id}/runs","href":"/api-reference/tasks/add-runs-to-task-group"},{"title":"Retrieve Task Group Run","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/groups/{taskgroup_id}/runs/{run_id}","href":"/api-reference/tasks/retrieve-task-group-run"},{"title":"Create Task Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/tasks/runs","href":"/api-reference/tasks/create-task-run"},{"title":"Retrieve Task Run","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}","href":"/api-reference/tasks/retrieve-task-run"},{"title":"Stream Task Run Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/events","href":"/api-reference/tasks/stream-task-run-events"},{"title":"Retrieve Task Run Input","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/input","href":"/api-reference/tasks/retrieve-task-run-input"},{"title":"Retrieve Task Run Result","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/tasks/runs/{run_id}/result","href":"/api-reference/tasks/retrieve-task-run-result"}]},{"group":"FindAll","pages":[{"title":"Fast Entity Search","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/entity-search","href":"/api-reference/findall/fast-entity-search"},{"title":"Ingest FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/ingest","href":"/api-reference/findall/ingest-findall-run"},{"title":"Create FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs","href":"/api-reference/findall/create-findall-run"},{"title":"Retrieve FindAll Run Status","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}","href":"/api-reference/findall/retrieve-findall-run-status"},{"title":"Cancel FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/cancel","href":"/api-reference/findall/cancel-findall-run"},{"title":"Add Enrichment to FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/enrich","href":"/api-reference/findall/add-enrichment-to-findall-run"},{"title":"Stream FindAll Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/events","href":"/api-reference/findall/stream-findall-events"},{"title":"Extend FindAll Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/findall/runs/{findall_id}/extend","href":"/api-reference/findall/extend-findall-run"},{"title":"FindAll Run Result","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/result","href":"/api-reference/findall/findall-run-result"},{"title":"Get FindAll Run Schema","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1beta/findall/runs/{findall_id}/schema","href":"/api-reference/findall/get-findall-run-schema"}]},{"group":"Monitor","pages":[{"title":"List Monitors","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors","href":"/api-reference/monitor/list-monitors"},{"title":"Create Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors","href":"/api-reference/monitor/create-monitor"},{"title":"Monitor Stats","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/stats","href":"/api-reference/monitor/monitor-stats"},{"title":"Retrieve Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/{monitor_id}","href":"/api-reference/monitor/retrieve-monitor"},{"title":"Cancel Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/cancel","href":"/api-reference/monitor/cancel-monitor"},{"title":"List Monitor Events","deprecated":null,"version":null,"openapi":"/public-openapi.json get /v1/monitors/{monitor_id}/events","href":"/api-reference/monitor/list-monitor-events"},{"title":"Trigger Monitor Run","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/trigger","href":"/api-reference/monitor/trigger-monitor-run"},{"title":"Update Monitor","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/monitors/{monitor_id}/update","href":"/api-reference/monitor/update-monitor"}]},{"group":"Memory","pages":[{"title":"Clear Memory","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/clear","href":"/api-reference/memory/clear-memory"},{"title":"Evict from Memory","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/evict","href":"/api-reference/memory/evict-from-memory"},{"title":"Retrieve Memory","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/memory/retrieve","href":"/api-reference/memory/retrieve-memory"}]},{"group":"Chat API (Beta)","pages":[{"title":"Chat Completions","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1beta/chat/completions","href":"/api-reference/chat-api-beta/chat-completions"}]},{"group":"Responses API","pages":[{"title":"Create Response","deprecated":null,"version":null,"openapi":"/public-openapi.json post /v1/responses","href":"/api-reference/responses-api/create-response"}]}]},{"tab":"Account API","icon":"gear","pages":[{"title":"Account API","href":"/service-api/balance/get-balance"}]},{"tab":"API Reference (legacy)","icon":"magnifying-glass","hidden":true,"pages":[{"title":"API Reference (legacy)","href":"/api-reference/legacy/search-beta/search"}]},{"tab":"Changelog","icon":"clock","pages":[{"title":"Changelog","href":"/resources/changelog"}]}]},"title":"Extract - Parallel","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}