You.com API reference

New to Corsair? See API access, authentication, and error handling.

Yousearch

youSearch

yousearch.youSearch Search the web using You.com’s search API. Returns LLM-ready web results and news articles. Risk: read

await corsair.youcom.api.yousearch.youSearch({});

Input

Name	Type	Required	Description
`query`	`string`	Yes	—
`count`	`number`	No	Defaults to 10.
`freshness`	`day \| week \| month \| year \| string`	No	—
`offset`	`number`	No	Defaults to 0.
`country`	`AR \| AU \| AT \| BE \| BR \| CA \| CL \| DK \| FI \| FR \| DE \| HK \| IN \| ID \| IT \| JP \| KR \| MY \| MX \| NL \| NZ \| NO \| CN \| PL \| PT \| PH \| RU \| SA \| ZA \| ES \| SE \| CH \| TW \| TR \| GB \| US`	No	—
`language`	`AR \| EU \| BN \| BG \| CA \| ZH-HANS \| ZH-HANT \| HR \| CS \| DA \| NL \| EN \| EN-GB \| ET \| FI \| FR \| GL \| DE \| EL \| GU \| HE \| HI \| HU \| IS \| IT \| JA \| KN \| KO \| LV \| LT \| MS \| ML \| MR \| NB \| PL \| PT-BR \| PT-PT \| PA \| RO \| RU \| SR \| SK \| SL \| ES \| SV \| TA \| TE \| TH \| TR \| UK \| VI`	No	Defaults to “EN”.
`safesearch`	`off \| moderate \| strict`	No	Defaults to “moderate”.
`livecrawl`	`web \| news \| all`	No	—
`livecrawl_formats`	`(html \| markdown)[]`	No	Defaults to [“html”].
`include_domains`	`string[]`	No	—
`exclude_domains`	`string[]`	No	—
`boost_domains`	`string[]`	No	—
`crawl_timeout`	`number`	No	Defaults to 10.

Output

Name	Type	Required	Description
`results`	`object`	Yes	—
`metadata`	`object`	Yes	—

results full type

{
  web?: {
    url: string,
    title: string,
    description?: string,
    snippets?: string[],
    thumbnail_url?: string,
    page_age?: string,
    contents?: {
      html?: string,
      markdown?: string
    },
    favicon_url?: string
  }[],
  news?: {
    title: string,
    description?: string,
    page_age?: string,
    thumbnail_url?: string,
    url: string,
    contents?: {
      html?: string,
      markdown?: string
    }
  }[]
}

metadata full type

{
  search_uuid: string,
  query: string,
  latency: number
}

Overview

Plugins

You.com API reference

Yousearch

youSearch

​Yousearch

​youSearch

Yousearch

youSearch