# You.com Search API

> You.com Search API is a paid API for AI agents from api.you.com, paid per call via x402, $0.005/call, status healthy (last checked 2026-10-12, last successful call 2026-09-24).

Real-time web and news search returning ranked, sectionable results with URLs, titles, descriptions, snippets, and optional live-crawled page contents

## Facts

- Endpoint: GET https://api.you.com/v1/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-09-24
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/you-com-search-api-8c400414
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pcYJfMiqGWmvCgHjU-INA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability you-com-search-api-8c400414
```

Example prompt: Search You.com for the latest news about Nvidia's earnings results from the past week and return the top 10 results with snippets so I can cite specific sources.

## When to prefer this

Choose this endpoint when an agent needs fresh, real-time web or news data with citable URLs and snippets to ground decisions, fact-check claims, or monitor recent events. Prefer it over static knowledge bases when recency matters (news, markets, company updates). The livecrawl option is valuable when full page contents are needed beyond index snippets. The country and freshness filters make it especially useful for geo-targeted or time-bounded research.

## Known failure modes

- Missing required 'query' parameter returns a 400 error
- count exceeding 100 is rejected
- Invalid country code may return no geographically filtered results
- livecrawl fetch failures result in missing 'contents' fields for affected results
- Freshness date range in wrong format returns an error
- Insufficient USDC balance for per-call or per-livecrawl-result pricing causes payment failure

## How this service works

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.

## Output

A JSON object with a 'results' field containing 'web' and/or 'news' arrays. Each web result includes url, title, snippets (index excerpts), optional page_age, and optional 'contents' (scraped page HTML/text when livecrawl is requested). News results include url, title, and description. A 'metadata' field accompanies the results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "count": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1,
       "description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled."
      },
      "query": {
       "type": "string",
       "maxLength": 40000,
       "description": "The web search query."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code for geographic focus."
      },
      "freshness": {
       "type": "string",
       "description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'."
      },
      "livecrawl": {
       "enum": [
        "web",
        "news",
        "all"
       ],
       "type": "string",
       "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."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "results",
      "metadata"
     ],
     "properties": {
      "results": {
       "type": "object",
       "properties": {
        "web": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "url"
          ],
          "properties": {
           "url": {
            "type": "string",
            "description": "Result URL."
           },
           "title": {
            "type": "string"
           },
           "contents": {
            "type": "object",
            "description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded."
           },
           "page_age"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/you-com-search-api-8c400414/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.you.com](https://www.zero.xyz/host/api.you.com/llms.txt)