Skip to content
Try for free
On this page

Integrations

You.com

Search, read, and research the web with You.com

Use You.com to search the web and news, retrieve page content, get cited answers, or run deep and financial research. Search supports date, country, language, and domain filters; research can return structured fields or run in the background for later status checks.

Image search requires early-access permission. Account Balance reports remaining API credits. Create a key on the You.com platform and provide it to the selected operation.

Use the block

Search the web and news with query-relevant highlights or full page content, fetch page contents, get cited answers, run deep or financial research, search images, and check API credit balance.

Actions

You.com Search

Search the web and news with You.com, returning LLM-ready results with optional query-relevant highlights or full page content.

Inputs and outputs

Input

ParameterTypeRequiredDescription
querystringYesSearch query. Supports search operators such as site: and filetype:
countnumberNoMaximum results to return per section (web and news). Defaults to 10
offsetnumberNoPage offset in multiples of count, from 0 to 9. Defaults to 0
freshnessstringNoResult recency: day, week, month, year, or a range like 2025-01-01to2025-12-31
countrystringNoTwo-letter country code that sets the geographic focus (e.g., US, GB, DE)
languagestringNoBCP 47 language code for results (e.g., EN, FR, ZH-HANS). Defaults to EN
safesearchstringNoContent moderation filter: off, moderate, or strict. Defaults to moderate
knowledgestringNoSet to core to also return knowledge results from licensed data providers
includeDomainsstringNoComma-separated domains to restrict results to (up to 500). Cannot be combined with exclude or boost domains
excludeDomainsstringNoComma-separated domains to remove from results (up to 500)
boostDomainsstringNoComma-separated domains to rank higher without filtering others (up to 500)
extractionModestringNoContent to extract per result: highlights (query-relevant passages) or full_page. Omit for snippets only
extractionSourcestringNoWhere full_page content comes from: blend (cache, then live crawl), cache, or fetch. Defaults to blend
extractionFormatsstringNoComma-separated full_page formats: markdown, html, or both. Defaults to markdown
crawlTimeoutnumberNoSeconds to wait for page content when crawling, from 1 to 60. Defaults to 10
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
webarrayWeb results
↳ urlstringURL of the result
↳ titlestringTitle of the result
↳ descriptionstringBrief description of the result
↳ snippetsarrayShort keyword-centered fragments (omitted when highlights extraction is used)
↳ thumbnailUrlstringThumbnail URL
↳ faviconUrlstringFavicon URL of the result's domain
↳ pageAgestringAge of the result
↳ highlightsarrayQuery-relevant passages (highlights extraction only)
↳ htmlstringFull page HTML (full_page only)
↳ markdownstringFull page Markdown (full_page only)
newsarrayNews results
↳ urlstringURL of the article
↳ titlestringTitle of the article
↳ descriptionstringBrief description of the article
↳ thumbnailUrlstringThumbnail URL
↳ pageAgestringUTC publication timestamp
↳ htmlstringFull page HTML (full_page only)
↳ markdownstringFull page Markdown (full_page only)
knowledgearrayKnowledge results from licensed data providers (when knowledge is core)
↳ typestringKind of knowledge result (currently answer)
↳ titlestringTitle of the knowledge result
↳ descriptionstringKnowledge drawn from licensed data
↳ asOfstringDate the data covers (YYYY-MM-DD)
↳ attributionarrayData provider credits
↳ namestringData provider name
↳ sourceDescriptionstringDescription of the provider
searchUuidstringUnique ID of the search
querystringQuery used to retrieve the results
latencynumberSearch latency in seconds

You.com Get Contents

Fetch the HTML, Markdown, and page metadata of one or more web pages with You.com.

Inputs and outputs

Input

ParameterTypeRequiredDescription
urlsstringYesComma-separated URLs to fetch content from
formatsstringNoComma-separated formats to return: markdown, html, metadata (JSON-LD and OpenGraph site info)
crawlTimeoutnumberNoSeconds to wait for page content, from 1 to 60. Defaults to 10
maxAgenumberNoMaximum age in seconds of cached content before the page is re-fetched. Defaults to no limit
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
pagesarrayContent of each fetched page
↳ urlstringURL of the fetched page
↳ titlestringTitle of the page
↳ htmlstringPage HTML (html format)
↳ markdownstringPage Markdown (markdown format)
↳ siteNamestringOpenGraph site name (metadata format)
↳ faviconUrlstringFavicon URL of the page's domain (metadata format)

You.com Answer

Get a synthesized answer to a question with numbered citations and the web results used to write it.

Inputs and outputs

Input

ParameterTypeRequiredDescription
querystringYesThe question to answer
freshnessstringNoResult recency: day, week, month, year, or a range like 2025-01-01to2025-12-31
countrystringNoTwo-letter country code that sets the geographic focus (e.g., US, GB, DE)
languagestringNoBCP 47 language code for results (e.g., EN, FR, DE)
safesearchstringNoContent moderation filter: off, moderate, or strict. Defaults to moderate
includeDomainsstringNoComma-separated domains to restrict results to (up to 500). Cannot be combined with exclude or boost domains
excludeDomainsstringNoComma-separated domains to remove from results (up to 500)
boostDomainsstringNoComma-separated domains to rank higher without filtering others (up to 500)
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
answerstringSynthesized answer with numbered inline citations referencing citations
citationsarraySources cited in the answer, in citation order
↳ sourcestringURL of the cited source
↳ excerptsarrayVerbatim excerpts from the source that support the answer
resultsarrayAll web results considered while writing the answer, cited or not
↳ urlstringURL of the source webpage
↳ titlestringTitle of the source webpage
↳ snippetsarrayText snippets previewing the content
↳ descriptionstringBrief description
↳ thumbnailUrlstringThumbnail URL
↳ pageAgestringAge of the result

You.com Research

Run multi-step web research on a question and get a thorough, cited answer, or start it as a background task.

Inputs and outputs

Input

ParameterTypeRequiredDescription
inputstringYesResearch question or complex query (up to 40,000 characters)
researchEffortstringNoDepth of research: lite (<10s), standard (10-30s), deep (<120s), exhaustive (<300s), or frontier (always runs in the background and returns a task ID). Defaults to standard
outputSchemajsonNoJSON Schema for structured output in content. Every object needs additionalProperties: false and all properties required. Not supported with lite
backgroundbooleanNoRun as a background task and return a task ID to poll with Get Research Task. Always on for frontier
includeDomainsstringNoComma-separated domains the research may use (up to 500). Cannot be combined with exclude or boost domains
excludeDomainsstringNoComma-separated domains the research must not search or visit (up to 500)
boostDomainsstringNoComma-separated domains to rank higher without filtering others (up to 500)
freshnessstringNoSource recency: day, week, month, year, or a range like 2025-01-01to2025-12-31
countrystringNoTwo-letter country code that focuses web results (e.g., US, GB, DE)
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
contentjsonMarkdown answer with numbered inline citations, or an object matching the output schema when one was supplied
contentTypestringFormat of content: text (Markdown) or object (structured output)
sourcesarrayWeb sources used to generate the answer
↳ urlstringURL of the source webpage
↳ titlestringTitle of the source webpage
↳ snippetsarrayExcerpts from the source used to generate the answer
warningsarrayWarnings raised during research, such as source access issues or partial results
taskIdstringBackground task ID to pass to Get Research Task (background only)
statusstringBackground task status: queued, running, completed, failed, or cancelled (background only)
streamUrlstringURL path of the task progress event stream (background only)
createdAtstringWhen the background task was created, RFC 3339 (background only)

You.com Get Research Task

Get the status of a background research task and, once completed, its cited answer and sources.

Inputs and outputs

Input

ParameterTypeRequiredDescription
taskIdstringYesID of the background research task
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
taskIdstringID of the background research task
taskTypestringTask type (research)
statusstringTask status: queued, running, completed, failed, or cancelled
createdAtstringWhen the task was created, RFC 3339
updatedAtstringWhen the task was last updated, RFC 3339
completedAtstringWhen the task reached a terminal status, RFC 3339
errorstringDiagnostic message when failed
taskInputjsonOriginal request parameters submitted for the task
↳ inputstringResearch question that was submitted
↳ researchEffortstringResearch effort level submitted
↳ backgroundbooleanWhether background mode was requested
↳ outputSchemajsonStructured output schema submitted
↳ sourceControljsonSource control configuration submitted
↳ typestringTask type (research)
contentjsonMarkdown answer with numbered inline citations, or an object matching the output schema when one was supplied
contentTypestringFormat of content: text (Markdown) or object (structured output)
sourcesarrayWeb sources used to generate the answer
↳ urlstringURL of the source webpage
↳ titlestringTitle of the source webpage
↳ snippetsarrayExcerpts from the source used to generate the answer
warningsarrayWarnings raised during research, such as source access issues or partial results

You.com Finance Research

Research a financial question across earnings reports, SEC filings, analyst coverage, and market news, and get a cited answer.

Inputs and outputs

Input

ParameterTypeRequiredDescription
inputstringYesFinancial research question (up to 40,000 characters)
researchEffortstringNoDepth of research: deep (<120s) or exhaustive (<300s). Defaults to deep
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
contentstringMarkdown answer with numbered inline citations referencing sources
contentTypestringFormat of content (text)
sourcesarrayWeb sources used to generate the answer
↳ urlstringURL of the source webpage
↳ titlestringTitle of the source webpage
↳ snippetsarrayExcerpts from the source used to generate the answer
warningsarrayWarnings raised during research, such as source access issues or partial results

You.com Search Images

Find image URLs for a query with You.com. Beta, and limited to You.com early-access API keys.

Inputs and outputs

Input

ParameterTypeRequiredDescription
querystringYesImage search query. Supports site:, filetype: (e.g., filetype:png), and OR
countnumberNoMaximum number of images to return, from 1 to 100. Defaults to 10
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
imagesarrayImage results
↳ titlestringTitle of the image result
↳ pageUrlstringURL of the page containing the image
↳ imageUrlstringDirect URL to the image
↳ thumbnailstringProxy-hosted thumbnail URL
↳ largeThumbnailstringLarger resized image URL; fall back to thumbnail or imageUrl if it fails
querystringQuery that was submitted
searchUuidstringUnique ID of the search

You.com Get Account Balance

Get the remaining You.com API credit balance for the account or organization that owns the API key.

Inputs and outputs

Input

ParameterTypeRequiredDescription
apiKeystringYesYou.com API key

Output

ParameterTypeDescription
accountIdstringStable hashed ID of the billing entity (user or organization)
accountTypestringBilling entity type (account)
balancenumberRemaining credit balance in cents (divide by 100 for USD)
Was this helpful?
Suggest an edit