{
"answer": "A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ...",
"search_results": [
{
"url": "https://en.wikipedia.org/wiki/Solar_eclipse",
"name": "Solar eclipse - Wikipedia",
"snippet": "A solar eclipse occurs when the Moon passes between Earth and the Sun, thereby obscuring the view of the Sun from a small part of Earth, totally or partially. Such an alignment occurs approximately every six months, during the eclipse season in its new moon phase, when the Moon's orbital plane is closest to the plane of Earth's orbit.\nIn partial and annular eclipses, only part of the Sun is obscured. Unlike a lunar eclipse, which may be viewed from anywhere on the night side of Earth, a solar eclipse can only be viewed from a relatively small area of the world. As such, although total solar eclipses occur somewhere on Earth every 18 months on average, they recur at any given place only once every 360 to 410 years.\nIf the Moon were in a perfectly circular orbit and in the same orbital plane as Earth, there would be total solar eclipses once a month, at every new moon. Instead, because the Moon's orbit is tilted at about 5 degrees to Earth's orbit, its shadow usually misses Earth ..."
}
]
}
API Reference
Smart API (Legacy)
POST
/
smart
Returns quick, reliable answers for a variety of questions
{
"answer": "A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ...",
"search_results": [
{
"url": "https://en.wikipedia.org/wiki/Solar_eclipse",
"name": "Solar eclipse - Wikipedia",
"snippet": "A solar eclipse occurs when the Moon passes between Earth and the Sun, thereby obscuring the view of the Sun from a small part of Earth, totally or partially. Such an alignment occurs approximately every six months, during the eclipse season in its new moon phase, when the Moon's orbital plane is closest to the plane of Earth's orbit.\nIn partial and annular eclipses, only part of the Sun is obscured. Unlike a lunar eclipse, which may be viewed from anywhere on the night side of Earth, a solar eclipse can only be viewed from a relatively small area of the world. As such, although total solar eclipses occur somewhere on Earth every 18 months on average, they recur at any given place only once every 360 to 410 years.\nIf the Moon were in a perfectly circular orbit and in the same orbital plane as Earth, there would be total solar eclipses once a month, at every new moon. Instead, because the Moon's orbit is tilted at about 5 degrees to Earth's orbit, its shadow usually misses Earth ..."
}
]
}
Before You Get StartedTo register for usage of our Smart API, please reach out via email at api@you.com.
Custom commands that allow you to tailor the responses to meet specific requirements or preferences. By providing detailed instructions, you can control the assistant’s tone, style, format, depth of information, and other response characteristics. This enables you to customize responses for different audiences, contexts, or purposes. Instructions up to 2.5K characters are supported by default. For longer instructions—up to 25K characters—custom pricing is available upon request at api@you.com.
Response
200 - application/json
A JSON object containing a dictionary with the answer and a list of search results
The main response generated by the API based on the provided query and instructions.
Example:
"A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ..."
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"You.com API","colors":{"primary":"#596CED","light":"#decef4","dark":"#596CED"},"logo":{"light":"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/light.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=e137388d4ab9a92522ac345398106fd6","dark":"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/dark.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=85ee41f940bc8d99aad0168c2d148d30"},"favicon":"/favicon.png","api":{"openapi":["openapi.yaml","openapi_chat.yaml"]},"background":{"decoration":"gradient","color":{"dark":"#090014"}},"navbar":{"links":[{"label":"Discord","href":"https://discord.com/invite/youdotcom"}],"primary":{"type":"button","label":"Get an API Key","href":"https://you.com/platform"}},"footer":{"socials":{"twitter":"https://twitter.com/youdotcom","linkedin":"https://www.linkedin.com/company/youdotcom"}},"icons":{"library":"lucide"},"styling":{},"integrations":{"ga4":{"measurementId":"G-D65GMT6MQN"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"you","hasAudioNarration":false,"actualSubdomain":"you","customDomains":["old-docs.you.com"],"gitSource":{"type":"github","owner":"su-sea","repo":"docs-example","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21c926539692d19e12cd4d","collectionId":"f58c71bd-37ef-4564-984d-fe4050e9be9a","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21c926539692d19e12cd4d:success","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":20},{"language":"default","tag":"Developer Resources","count":9},{"language":"default","tag":"Tutorials","count":8},{"language":"default","tag":"Get Started","count":4},{"language":"default","tag":"Tools","count":4},{"language":"default","tag":"Agent","count":3},{"language":"default","tag":"Custom Agent","count":3},{"language":"default","tag":"Other Tools","count":3},{"language":"default","tag":"Advanced Agent","count":2},{"language":"default","tag":"Search","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":".text-light{margin-top:2rem;margin-bottom:4%;font-size:2rem;font-weight:600;font-family:Arial,Helvetica,sans-serif;color:#000}.dark\\:text-dark:is(.dark *){color:#fff}"},{"filePath":"styles/custom.css","content":".custom-welcome-page>div{max-width:none!important;padding:0!important}.custom-welcome-page>div>h1:first-child{display:none}.custom-welcome-page #welcome{display:flex;flex-direction:column;justify-content:flex-start;align-items:center;width:100%;max-width:1200px;margin:0 auto;min-height:auto;padding:2rem .5rem}.text-light{margin-top:2rem;margin-bottom:4%;font-size:2rem;font-weight:600;font-family:Arial,Helvetica,sans-serif;color:#000}.dark\\:text-dark:is(.dark *){color:#fff}.card-container{display:grid;grid-template-columns:repeat(auto-fit,minmax(250px,1fr));gap:20px}.prose pre{background:0 0;box-shadow:none}.dark .prose pre{background:#0b1220;border:1px solid rgba(255,255,255,.08)}.beta-badge{display:inline-block;padding:2px 8px;margin:8px 0 12px;font-size:12px;font-weight:600;letter-spacing:.02em;color:#1e3a8a;background:#dbeafe;border:1px solid #93c5fd;border-radius:9999px}.dark .beta-badge{color:#bfdbfe;background:rgba(30,58,138,.35);border-color:#60a5fa}.prose h1{display:inline-block;margin-right:8px}.prose h1+.beta-badge{display:inline-block;vertical-align:middle;position:relative;top:-2px}#custom-agents-page:before{content:\"\"}.prose h1:has(+#custom-agents-page){display:inline-block;margin-right:8px}.prose h1:has(+#custom-agents-page)::after{content:\"Beta\";display:inline-block;padding:2px 8px;margin-left:8px;font-size:12px;font-weight:600;letter-spacing:.02em;color:#1e3a8a;background:#dbeafe;border:1px solid #93c5fd;border-radius:9999px}.dark .prose h1:has(+#custom-agents-page)::after{color:#bfdbfe;background:rgba(30,58,138,.35);border-color:#60a5fa}"}],"page":{"pagePath":"api-reference/smart","slug":"/api-reference/smart","pageMetadata":{"title":"Smart API (Legacy)","og:title":"Smart API | YOU API | Chat API","og:description":"Returns quick, reliable answers for a variety of questions","openapi":"openapi_chat POST /smart","description":null,"href":"/api-reference/smart"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(Note,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Before You Get Started`})}),_jsxs(_components.p,{children:[`To register for usage of our Smart API, please reach out via email at `,_jsx(_components.a,{href:`mailto:api@you.com`,children:`api@you.com`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Smart API (Legacy)","og:title":"Smart API | YOU API | Chat API","og:description":"Returns quick, reliable answers for a variety of questions","openapi":"openapi_chat POST /smart","description":null,"href":"/api-reference/smart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Returns quick, reliable answers for a variety of questions","requestBody":"f31f6e96-0c10-4482-8426-021e780f41e2","responses":{"200":"2e83ce08-a580-4018-8440-a7e2142b983a"},"method":"post","type":"path","servers":["6a576717-d1d0-4a40-a7c3-c76521d87175"],"security":["c5ab87c1-d358-4ae1-8132-d6624ef7f788"],"path":"/smart","baseUrlOptions":["https://chat-api.you.com"],"title":"Returns quick, reliable answers for a variety of questions","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The main question or statement to be answered. This input directs the scope and context of the response.","uniqueKey":"query","typeLabel":"string"},"chat_id":{"type":"string","description":"A hexadecimal `UUID` to maintain continuity within the conversation. This can be a randomly generated string that uniquely identifies the session.","format":"uuid","uniqueKey":"chat_id","typeLabel":"string\u003cuuid>"},"instructions":{"type":"string","description":"Custom commands that allow you to tailor the responses to meet specific requirements or preferences. By providing detailed instructions, you can control the assistant’s *tone, style, format, depth of information,* and other response characteristics. This enables you to customize responses for different audiences, contexts, or purposes. Instructions up to `2.5K characters` are supported by default. For longer instructions—up to `25K characters`—custom pricing is available upon request at **api@you.com**.","uniqueKey":"instructions","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"\u003cstring>","chat_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","instructions":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2e83ce08-a580-4018-8440-a7e2142b983a":{"description":"A JSON object containing a dictionary with the answer and a list of search results","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string","description":"The main response generated by the API based on the provided `query` and `instructions`.","example":"A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ...","uniqueKey":"answer","typeLabel":"string"},"search_results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the specific search result.","example":"https://en.wikipedia.org/wiki/Solar_eclipse","uniqueKey":"search_results.items.[INDEX].url","typeLabel":"string"},"name":{"type":"string","description":"The title or name of the search result.","example":"Solar eclipse - Wikipedia","uniqueKey":"search_results.items.[INDEX].name","typeLabel":"string"},"snippet":{"type":"string","description":"A brief summary or description of the search result content.","example":"A solar eclipse occurs when the Moon passes between Earth and the Sun, thereby obscuring the view of the Sun from a small part of Earth, totally or partially. Such an alignment occurs approximately every six months, during the eclipse season in its new moon phase, when the Moon's orbital plane is closest to the plane of Earth's orbit.\nIn partial and annular eclipses, only part of the Sun is obscured. Unlike a lunar eclipse, which may be viewed from anywhere on the night side of Earth, a solar eclipse can only be viewed from a relatively small area of the world. As such, although total solar eclipses occur somewhere on Earth every 18 months on average, they recur at any given place only once every 360 to 410 years.\nIf the Moon were in a perfectly circular orbit and in the same orbital plane as Earth, there would be total solar eclipses once a month, at every new moon. Instead, because the Moon's orbit is tilted at about 5 degrees to Earth's orbit, its shadow usually misses Earth ...","uniqueKey":"search_results.items.[INDEX].snippet","typeLabel":"string"}},"uniqueKey":"search_results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"search_results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"answer":"A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ...","search_results":[{"url":"https://en.wikipedia.org/wiki/Solar_eclipse","name":"Solar eclipse - Wikipedia","snippet":"A solar eclipse occurs when the Moon passes between Earth and the Sun, thereby obscuring the view of the Sun from a small part of Earth, totally or partially. Such an alignment occurs approximately every six months, during the eclipse season in its new moon phase, when the Moon's orbital plane is closest to the plane of Earth's orbit.\nIn partial and annular eclipses, only part of the Sun is obscured. Unlike a lunar eclipse, which may be viewed from anywhere on the night side of Earth, a solar eclipse can only be viewed from a relatively small area of the world. As such, although total solar eclipses occur somewhere on Earth every 18 months on average, they recur at any given place only once every 360 to 410 years.\nIf the Moon were in a perfectly circular orbit and in the same orbital plane as Earth, there would be total solar eclipses once a month, at every new moon. Instead, because the Moon's orbit is tilted at about 5 degrees to Earth's orbit, its shadow usually misses Earth ..."}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c5ab87c1-d358-4ae1-8132-d6624ef7f788":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"A unique API Key required to authorize API access. Ensure it is kept confidential. Get a free API Key at you.com/platform.","scopes":[]}}},"servers":{"6a576717-d1d0-4a40-a7c3-c76521d87175":{"url":"https://chat-api.you.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"A unique API Key required to authorize API access. Ensure it is kept confidential. Get a free API Key at you.com/platform.","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"A unique API Key required to authorize API access. Ensure it is kept confidential. Get a free API Key at you.com/platform.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi_chat.yaml"},"subdomain":"you","siteName":"You.com API","title":"Smart API | YOU API | Chat API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-08T20:25:32.000Z","originalFileLocation":"api-reference/smart.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=\"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=\"application-name\" content=\"You.com API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Smart API | YOU API | Chat API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns quick, reliable answers for a variety of questions\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"You.com API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://old-docs.you.com/api-reference/smart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://you.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Smart+API+%28Legacy%29\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=87582102fa935d2d92ac24a4f68d311ac7be5ed7b5552f2437939ce28c5fa008\">\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=\"Smart API | YOU API | Chat API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns quick, reliable answers for a variety of questions\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://you.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Smart+API+%28Legacy%29\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=87582102fa935d2d92ac24a4f68d311ac7be5ed7b5552f2437939ce28c5fa008\">\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/you/faYhI-oxxSDbXhz9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"You.com API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#596CED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://old-docs.you.com/api-reference/smart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/smart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://old-docs.you.com/#organization\",\"name\":\"You.com API\",\"url\":\"https://old-docs.you.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/light.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=e137388d4ab9a92522ac345398106fd6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://old-docs.you.com#website\",\"name\":\"You.com API\",\"url\":\"https://old-docs.you.com\",\"publisher\":{\"@id\":\"https://old-docs.you.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://old-docs.you.com/api-reference/smart#webpage\",\"url\":\"https://old-docs.you.com/api-reference/smart\",\"name\":\"Smart API (Legacy)\",\"dateModified\":\"2025-10-08T20:25:32.000Z\",\"isPartOf\":{\"@id\":\"https://old-docs.you.com#website\"},\"breadcrumb\":{\"@id\":\"https://old-docs.you.com/api-reference/smart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://old-docs.you.com/api-reference/smart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://old-docs.you.com/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Smart API (Legacy)\",\"item\":\"https://old-docs.you.com/api-reference/smart\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://old-docs.you.com/api-reference/smart#apireference\",\"headline\":\"Smart API (Legacy)\",\"name\":\"Smart API (Legacy)\",\"url\":\"https://old-docs.you.com/api-reference/smart\",\"mainEntityOfPage\":{\"@id\":\"https://old-docs.you.com/api-reference/smart#webpage\"},\"dateModified\":\"2025-10-08T20:25:32.000Z\",\"publisher\":{\"@id\":\"https://old-docs.you.com/#organization\"},\"isPartOf\":{\"@id\":\"https://old-docs.you.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"You.com API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"You.com API","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/get-started/welcome"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Search","openapi":"get /v1/search","href":"/api-reference/search"},{"group":"Agent","expanded":true,"pages":[{"title":"Advanced Agent (Beta)","openapi":"openapi_agents_advanced POST /v1/agents/runs","href":"/api-reference/advanced-agent"},{"title":"Custom Agent (Beta)","openapi":"openapi_agents_custom POST /v1/agents/runs","href":"/api-reference/custom-agent"},{"title":"Express Agent (Beta)","openapi":"openapi_agents POST /v1/agents/runs","href":"/api-reference/express-agent"}]},{"title":"Contents","openapi":"post /v1/contents","href":"/api-reference/contents"},{"title":"Images","openapi":"openapi_images get /images","href":"/api-reference/images"},{"title":"Live News","openapi":"openapi_livenews GET /livenews","href":"/api-reference/news"},{"title":"Search (Legacy)","openapi":"get /search","description":null,"href":"/api-reference/search-legacy"},{"title":"Smart API (Legacy)","openapi":"openapi_chat POST /smart","href":"/api-reference/smart"},{"title":"Research API (Legacy)","openapi":"openapi_chat POST /research","description":null,"href":"/api-reference/research"}]}]},{"tab":"Tools","pages":[{"title":"Tools","href":"/tools/mcp-server"}]},{"tab":"Developer Resources","pages":[{"title":"Developer Resources","href":"/developer-resources/tutorials/search/guides"}]}]},"title":"Smart API | YOU API | Chat API","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"]}