GET
$0.0057 default
/v1/searchDescription
You.com Search API: real-time web search returning ranked results grouped by section (results.web, results.news), each with url, title and description; web results also carry snippets. Use when an agent needs fresh, citable web data (news, markets, company facts) to ground a decision. Query params: query (required), count 1-100 (default 10), livecrawl (web|news|all; fetches live page contents, charged per result), country, freshness. Paid per call in USDC.
Pricing
$0.0057 default
Parameters
{
"properties": {
"count": {
"default": 10,
"description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code for geographic focus.",
"type": "string"
},
"freshness": {
"description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'.",
"type": "string"
},
"livecrawl": {
"description": "Fetch live page contents for the results instead of serving index snippets alone. Priced per result on top of the base call price, so the quoted amount scales with count. Omit for the base price.",
"enum": [
"web",
"news",
"all"
],
"type": "string"
},
"query": {
"description": "The web search query.",
"maxLength": 40000,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Example response
{
"metadata": {
"latency": 0.42,
"query": "NVDA earnings guidance Q2 2026",
"search_uuid": "0a1d1f6e-6a1a-4a6e-9a9a-5f4f2b7d3c11"
},
"results": {
"news": [
{
"description": "Management guided next quarter above consensus.",
"page_age": "2026-08-01T14:02:00",
"thumbnail_url": "https://example.com/thumb/nvda-call.jpg",
"title": "NVIDIA earnings call: guidance above consensus",
"url": "https://example.com/nvda-earnings-call"
}
],
"web": [
{
"description": "NVIDIA lifted its outlook on data-center demand.",
"favicon_url": "https://example.com/favicon.ico",
"page_age": "2026-08-01T14:02:00",
"snippets": [
"NVIDIA expects revenue of ... driven by data-center GPU demand."
],
"thumbnail_url": "https://example.com/thumb/nvda-guidance.jpg",
"title": "NVIDIA raises Q2 revenue guidance",
"url": "https://example.com/nvda-guidance"
}
]
}
}