NOTE: The You.com news API is currently available to exclusive early access partners.To express interest in early access, please reach out via email to api@you.com.
ATTENTION: The correct cURL code to use in your API call is in the playground. Click on Try it in the bar above to open the playground.
{"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/news","slug":"/api-reference/news","pageMetadata":{"title":"Live News","og:title":"API Reference News | API Authorizations | API Query Parameters","og:description":"Learn the query parameters and authorizations necessary to conduct an API news search with the YOU API.","openapi":"openapi_livenews GET /livenews","description":null,"href":"/api-reference/news"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,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},{Callout,Heading,Note}=_components;if(!Callout)_missingMdxReference(`Callout`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`NOTE`}),`: The You.com news API is currently available to exclusive early access partners.`]}),_jsxs(_components.p,{children:[`To express interest in early access, please reach out via email to `,_jsx(_components.a,{href:`mailto:api@you.com`,children:`api@you.com`}),`.`]})]}),`\n`,_jsxs(Callout,{icon:`eyes`,color:`#FF8000`,iconType:`regular`,children:[_jsx(_components.strong,{children:`ATTENTION`}),`: The correct cURL code to use in your API call is in the playground. Click on `,_jsx(_components.strong,{children:`Try it`}),` in the bar above to open the playground.`]}),`\n`,_jsx(Heading,{level:`2`,id:`description`,children:`Description`}),`\n`,_jsx(_components.p,{children:`This endpoint retrieves responses from news media websites that are relevant to the user’s query.`})]})}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":"Live News","og:title":"API Reference News | API Authorizations | API Query Parameters","og:description":"Learn the query parameters and authorizations necessary to conduct an API news search with the YOU API.","openapi":"openapi_livenews GET /livenews","description":null,"href":"/api-reference/news"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Description","slug":"description","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Returns a list of live news from query","parameters":["50cec115-14e2-4ef8-8247-7e98215b19f3","8e22f12e-2be7-420d-b7f1-b35ba333e762"],"responses":{"200":"88860aa5-f456-4813-a98d-67fb8c8acfd7","401":"613fd896-10f7-496a-a9fa-9ddb61c5c2d3","403":"2bb83445-6a72-4455-a6b8-cdf756659a1b","500":"d2e2926d-c862-4587-be0d-dd1cd1727266"},"method":"get","type":"path","servers":["a51e5635-5ef5-422a-bc79-a58301376631"],"security":["e46ae250-d125-4bc5-9701-3f6a3914b8ef"],"path":"/livenews","baseUrlOptions":["https://api.ydc-index.io"],"title":"Returns a list of live news from query","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"50cec115-14e2-4ef8-8247-7e98215b19f3":{"name":"q","in":"query","required":true,"description":"Search query used to retrieve relevant news from the web.","schema":{"example":"Your query about news","type":"string","default":"Your query about news","isRequired":true,"description":"Search query used to retrieve relevant news from the web.","uniqueKey":"","typeLabel":"string"}},"8e22f12e-2be7-420d-b7f1-b35ba333e762":{"name":"count","in":"query","required":false,"description":"Specifies the maximum number of news results to return.","schema":{"type":"integer","minimum":1,"maximum":40,"isRequired":false,"description":"Specifies the maximum number of news results to return.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"88860aa5-f456-4813-a98d-67fb8c8acfd7":{"description":"A JSON object containing news results.","content":{"application/json":{"schema":{"type":"object","properties":{"news":{"type":"object","properties":{"query":{"type":"object","properties":{"original":{"type":"string","description":"Returns the original query submitted.","example":"Your query about news","uniqueKey":"news.query.original","typeLabel":"string"},"spellcheck_off":{"type":"boolean","default":false,"uniqueKey":"news.query.spellcheck_off","typeLabel":"boolean"}},"uniqueKey":"news.query","typeLabel":"object"},"results":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string","description":"How long ago the news was published.","example":"6h","uniqueKey":"news.results.items.[INDEX].age","typeLabel":"string"},"description":{"type":"string","description":"The publisher's description.","example":"Any news for you!","uniqueKey":"news.results.items.[INDEX].description","typeLabel":"string"},"meta_url":{"type":"object","description":"The URL's metadata.","properties":{"hostname":{"description":"The domain name of the URL.","type":"string","example":"www.wsj.com","uniqueKey":"news.results.items.[INDEX].meta_url.hostname","typeLabel":"string"},"netloc":{"type":"string","example":"wsj.com","uniqueKey":"news.results.items.[INDEX].meta_url.netloc","typeLabel":"string"},"path":{"description":"The URL's path.","type":"string","example":"> world > china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f","uniqueKey":"news.results.items.[INDEX].meta_url.path","typeLabel":"string"},"scheme":{"type":"string","example":"https","uniqueKey":"news.results.items.[INDEX].meta_url.scheme","typeLabel":"string"}},"uniqueKey":"news.results.items.[INDEX].meta_url","typeLabel":"object"},"page_age":{"description":"The timestamp of the publication date.","type":"string","format":"date-time","example":"2025-06-25T11:41:00","uniqueKey":"news.results.items.[INDEX].page_age","typeLabel":"string\u003cdate-time>"},"source_name":{"description":"The publisher's name.","type":"string","example":"WSJ","uniqueKey":"news.results.items.[INDEX].source_name","typeLabel":"string"},"thumbnail":{"type":"object","description":"The image's URI.","properties":{"src":{"type":"string","format":"uri","example":"https://images.wsj.net/im-42431776?width=700\u0026height=449","uniqueKey":"news.results.items.[INDEX].thumbnail.src","typeLabel":"string\u003curi>"}},"uniqueKey":"news.results.items.[INDEX].thumbnail","typeLabel":"object"},"title":{"description":"The news article's title.","type":"string","example":"Exclusive | China Is Tracking Down Its Rare-Earth Experts—and Taking Away Passports","uniqueKey":"news.results.items.[INDEX].title","typeLabel":"string"},"type":{"type":"string","example":"news_result","uniqueKey":"news.results.items.[INDEX].type","typeLabel":"string"},"url":{"type":"string","format":"uri","example":"https://www.wsj.com/world/china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f?gaa_at=eafs\u0026gaa_n=ASWzDAiVjqRNxFmx5h0MkVKtlAuVL0B8yQIDw3q7BheARNdP_8kbbzG50lB9\u0026gaa_ts=685c3985\u0026gaa_sig=x_9tkHwj_WnP29wU-sgBvg0clotjEVKnMak6vgU98b6mdtl5vl0Iu8k96Ep4H_YZRrt-38wFlodzzWcHrWYNWQ%3D%3D","uniqueKey":"news.results.items.[INDEX].url","typeLabel":"string\u003curi>"},"metadata":{"type":"object","uniqueKey":"news.results.items.[INDEX].metadata","typeLabel":"object"},"article_id":{"oneOf":[{"type":"string","uniqueKey":"news.results.items.[INDEX].article_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"news.results.items.[INDEX].article_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"news.results.items.[INDEX].article_id","typeLabel":"string | null"}},"uniqueKey":"news.results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"news.results","typeLabel":"object[]"},"type":{"type":"string","example":"news","uniqueKey":"news.type","typeLabel":"string"},"metadata":{"type":"object","properties":{"request_uuid":{"type":"string","format":"uuid","example":"942ccbdd-7705-4d9c-9d37-4ef386658e90","uniqueKey":"news.metadata.request_uuid","typeLabel":"string\u003cuuid>"}},"uniqueKey":"news.metadata","typeLabel":"object"}},"uniqueKey":"news","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"news":{"query":{"original":"Your query about news","spellcheck_off":false},"results":[{"age":"6h","description":"Any news for you!","meta_url":{"hostname":"www.wsj.com","netloc":"wsj.com","path":"> world > china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f","scheme":"https"},"page_age":"2025-06-25T11:41:00","source_name":"WSJ","thumbnail":{"src":"https://images.wsj.net/im-42431776?width=700\u0026height=449"},"title":"Exclusive | China Is Tracking Down Its Rare-Earth Experts—and Taking Away Passports","type":"news_result","url":"https://www.wsj.com/world/china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f?gaa_at=eafs\u0026gaa_n=ASWzDAiVjqRNxFmx5h0MkVKtlAuVL0B8yQIDw3q7BheARNdP_8kbbzG50lB9\u0026gaa_ts=685c3985\u0026gaa_sig=x_9tkHwj_WnP29wU-sgBvg0clotjEVKnMak6vgU98b6mdtl5vl0Iu8k96Ep4H_YZRrt-38wFlodzzWcHrWYNWQ%3D%3D","metadata":{},"article_id":"\u003cstring>"}],"type":"news","metadata":{"request_uuid":"942ccbdd-7705-4d9c-9d37-4ef386658e90"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"613fd896-10f7-496a-a9fa-9ddb61c5c2d3":{"description":"Unauthorized. Problems with API key.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Error detail message.","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingApiKey":{"title":"missingApiKey","value":{"detail":"API key is required"}},"invalidOrExpired":{"title":"invalidOrExpired","value":{"detail":"Invalid or expired API key"}},"otherAuthParsing":{"title":"otherAuthParsing","value":{"detail":"\u003cerror message>"}}},"exampleType":"examples"}},"exampleType":"examples"},"2bb83445-6a72-4455-a6b8-cdf756659a1b":{"description":"Forbidden. API key lacks scope for this path.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missingScopes":{"title":"missingScopes","value":{"detail":"Missing required scopes"}}},"exampleType":"examples"}},"exampleType":"examples"},"d2e2926d-c862-4587-be0d-dd1cd1727266":{"description":"Internal Server Error during authentication/authorization middleware.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"authFailure":{"title":"authFailure","value":{"detail":"Internal authentication error"}},"authorizationFailure":{"title":"authorizationFailure","value":{"detail":"Internal authorization error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e46ae250-d125-4bc5-9701-3f6a3914b8ef":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"The unique API Key required to authorize API access. Learn how to get yours in the [“Get your API key” section of the documentation](/get-started/quickstart#get-your-api-key).","scopes":[]}}},"servers":{"a51e5635-5ef5-422a-bc79-a58301376631":{"url":"https://api.ydc-index.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"The unique API Key required to authorize API access. Learn how to get yours in the [“Get your API key” section of the documentation](/get-started/quickstart#get-your-api-key).","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"The unique API Key required to authorize API access. Learn how to get yours in the [“Get your API key” section of the documentation](/get-started/quickstart#get-your-api-key).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi_livenews.yaml"},"subdomain":"you","siteName":"You.com API","title":"API Reference News | API Authorizations | API Query Parameters","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-11-17T18:29:08.622Z","originalFileLocation":"api-reference/news.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=\"API Reference News | API Authorizations | API Query Parameters\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn the query parameters and authorizations necessary to conduct an API news search with the YOU API.\">\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/news\">\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=Live+News\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=7acd199915b65d69e22ae422a67434dd931df9acb151c12a2b567d405e6e378b\">\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=\"API Reference News | API Authorizations | API Query Parameters\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn the query parameters and authorizations necessary to conduct an API news search with the YOU API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://you.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Live+News\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=7acd199915b65d69e22ae422a67434dd931df9acb151c12a2b567d405e6e378b\">\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/news\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/news.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/news#webpage\",\"url\":\"https://old-docs.you.com/api-reference/news\",\"name\":\"Live News\",\"dateModified\":\"2025-11-17T18:29:08.622Z\",\"isPartOf\":{\"@id\":\"https://old-docs.you.com#website\"},\"breadcrumb\":{\"@id\":\"https://old-docs.you.com/api-reference/news#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://old-docs.you.com/api-reference/news#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://old-docs.you.com/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Live News\",\"item\":\"https://old-docs.you.com/api-reference/news\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://old-docs.you.com/api-reference/news#apireference\",\"headline\":\"Live News\",\"name\":\"Live News\",\"url\":\"https://old-docs.you.com/api-reference/news\",\"mainEntityOfPage\":{\"@id\":\"https://old-docs.you.com/api-reference/news#webpage\"},\"dateModified\":\"2025-11-17T18:29:08.622Z\",\"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","description":null,"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","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":"API Reference News | API Authorizations | API Query Parameters","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"]}